Lint

Skill: /lint

Trigger

User types: /lint

What to Check

1. Contradictions

• Read all wiki pages in: concepts/, entities/, patterns/, best-practices/, comparisons/
• Flag pairs of pages that make conflicting claims about the same topic
• Format: ⚠️ CONTRADICTION: [[page-a]] vs [[page-b]] — "" conflicts with ""

2. Orphan Pages

• Find pages in wiki/ (ALL subdirectories including queries/) with NO inbound [[wikilinks]]
• These are invisible in the Obsidian graph and will never be surfaced by /query
• Format: 🔗 ORPHAN: [[page-name]] — no pages link to this

3. Stub Pages

• Find wiki pages with fewer than 5 meaningful content lines (ignoring frontmatter, headings, empty lines)
• Format: 📄 STUB: [[page-name]] — only content lines

4. Broken Links

• Find [[wikilinks]] in page bodies that point to non-existent pages
• Format: ❌ BROKEN LINK: [[missing-page]] referenced in [[source-page]]

5. Vocab Gaps

• Find tech terms used in wiki page bodies (as [[wikilinks]] or plain text) not present in vocabs/index.md
• These cause vocabulary drift — same concept with different page names
• Format: 📚 VOCAB GAP: "" used in [[page-name]] but not in vocabs/index.md

6. Coverage Gaps

• Identify vocab terms in vocabs/index.md that have NO corresponding wiki page yet
• These are knowledge areas not yet explored
• Format: 🗺️ COVERAGE GAP: "" in vocabs/ has no wiki page yet

7. Index Accuracy

• Verify wiki/index.md entries match actual files in wiki/ subdirectories
• Flag: entries in index with no matching file (stale entries)
• Flag: files in wiki/ with no entry in index (missing entries)
• Format: 🗂️ INDEX MISMATCH: [[page-name]] in index but file not found
• Format: 🗂️ INDEX MISSING: file wiki//.md has no index entry

8. Overview Staleness

• Check wiki/overview.md "Sources ingested" count vs actual files in wiki/sources/
• Check wiki/overview.md "Wiki pages" count vs actual wiki/index.md pages count
• If counts are off: flag and suggest running /compile to resync
• Format: 📊 OVERVIEW STALE: overview says sources, actual count is

After Checks — Update wiki/overview.md

After all checks complete, update wiki/overview.md:

• Update "Last lint:" date to today
• Update source and page counts to match actual state
• Update upd: in frontmatter

Output Format

Print a grouped report: LINT REPORT — [YYYY-MM-DD] ───────────────────────── ⚠️ Contradictions: 🔗 Orphans: 📄 Stubs: ❌ Broken links: 📚 Vocab gaps: 🗺️ Coverage gaps: 🗂️ Index issues: 📊 Overview issues: ───────────────────────── ───────────────────────── Suggested next sources to ingest:

Append to wiki/log.md:

[YYYY-MM-DD] lint | Health check

issues found. .