wiki-lint

1# Lint the wiki
2 
3Use the portable lint engine as the source of truth. Lint observes vault state;
4it does not create reports, dashboards, canvases, stubs, or fixes.
5 
6Resolve the installed product root from this skill's own location, not from the
7vault or current working directory:
8 
9```bash
10PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
11CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
12test -f "$CORE"
13```
14 
15Every `../wiki/references/` link in this file resolves the same way, relative
16to this skill's own directory under `$PRODUCT_ROOT`, never relative to the
17selected vault's `wiki/` directory.
18 
19## Run
20 
21Resolve the user vault, then run one of:
22 
23```bash
24python3 "$CORE" lint --vault "$VAULT"
25python3 "$CORE" lint --vault "$VAULT" --format markdown
26python3 "$CORE" lint --vault "$VAULT" --exclude "wiki/scratchpad/*"
27```
28 
29The repeatable `--exclude GLOB` flag scopes a path (for example a scratchpad
30folder) out of page, link-resolution, orphan, frontmatter, empty-section, and
31stale-index scanning.
32 
33Use `--strict` only when a nonzero exit for findings is useful in automation.
34The command remains read-only either way.
35 
36The deterministic parser understands Obsidian wikilinks and embeds, Markdown
37links, aliases, heading and block fragments, escaped aliases, and code fences.
38It skips dot-prefixed directories by default, mirroring Obsidian's own
39indexer. Link resolution honors `.gitignore` files inside the vault (no `git`
40…