wiki-lintlisted
Install: claude install-skill ihudak/ihudak-claude-plugins
# 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:
```bash
[ -d "wiki" ] || { echo "Wiki not initialised — run /wiki-ingest to create the first page."; exit 0; }
```
```bash
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.
```bash
find "<VAULT_PATH>" -name "<linked-title>.md"
```
Severity: **high** — dead links silently