wiki-lint

wiki-lint

Read skills/wiki-schema/SKILL.md fully before proceeding.

Invoke with: /wiki-lint

---

Step 1 — Resolve VAULT_PATH

Vault path: ~/obsidian_vault by default; set VAULT_PATH to override. WSL users with a Windows-side vault must set VAULT_PATH explicitly (e.g. /mnt/c/Users/<name>/obsidian_vault).

---

Step 2 — Enumerate all wiki pages

First verify the wiki directory exists:

[ -d "wiki" ] || { echo "Wiki not initialised — run /wiki-ingest to create the first page."; exit 0; }

find "wiki" -name "*.md" \
  -not -name "_index.md" \
  -not -name "_log.md" \
  -not -name "hot.md"

Also read wiki/_index.md for the catalog (skip if absent) and wiki/_manifest.json for ingest history (skip if absent).

---

Step 3 — Run all lint checks

Work through each check. Collect findings before writing the report.

Check 1 — Orphan pages

A wiki page is an orphan if:

• No other wiki page contains a [[wikilink]] pointing to it, AND
• It is not listed in _index.md

Scan every wiki page body and _index.md for wikilinks. Any page not referenced by either is an orphan.

Severity: medium (orphans may be intentional seeds — do not auto-delete).

Check 2 — Dead links

For every [[wikilink]] found in wiki page bodies and frontmatter related: lists: check that a file with a matching basename exists somewhere in the vault.

find "<VAULT_PATH>" -name "<linked-title>.md"

Severity: high — dead links silently break the wiki graph.

Check 3 — Stale sources (Layer 1 files changed since ingest)

For every Layer 1 file recorded in _manifest.json:

1. Check if the file still exists.
2. Compute its current hash: md5sum "<filepath>" | cut -d' ' -f1
3. Compare to the manifest hash.

If hash differs: the source has changed since it was ingested. The wiki pages derived from it may be outdated.

Severity: medium — flag for re-ingest, do not auto-re-ingest.

Check 4 — Contradictions

Scan all wiki page bodies for > [!warning] callouts containing "contradiction" or "conflict". These were flagged during ingest and need human resolution.