Personal Wiki — Lint
Health-check the wiki, auto-fix safe issues, and report the rest with actionable fixes.
Audit Steps
Run all checks below, then present a consolidated report.
1. Broken wikilinks
Scan all wiki pages for
references. For each link, verify the target page exists. Report any broken links.
bash
# Find all wikilinks across wiki pages
grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u
Cross-reference against actual files in
.
Auto-fix: If the target page exists under a slightly different name (e.g. case difference, missing hyphen), fix the link automatically.
2. Orphan pages
Find pages with no inbound links — no other page references them via
.
- Extract the page name (filename without extension)
- Search all other wiki pages for
- If no other page links to it, it's an orphan
3. Contradictions
Read pages that share entities or concepts and look for conflicting claims. Flag when:
- Two source summaries make opposing claims about the same topic
- An entity page contains information that conflicts with a source summary
- Dates, figures, or factual claims differ between pages
4. Stale claims
Cross-reference source dates with wiki content. Flag when:
- A concept page cites only old sources and newer sources exist on the same topic
- Entity information hasn't been updated despite newer sources mentioning that entity
5. Missing pages
Scan for
that point to pages that don't exist yet. These are topics the wiki mentions but hasn't given their own page. Assess whether they warrant a page.
6. Missing cross-references
Find pages that discuss the same topics but don't link to each other. Look for:
- Entity pages that mention concepts without linking them
- Concept pages that mention entities without linking them
- Source summaries that cover the same topic but don't reference each other
7. Index consistency
Verify
is complete and accurate:
- Every page in , , , has an index entry
- No index entries point to deleted pages
- Entries are under the correct category header
Auto-fix: Add missing index entries. Remove entries pointing to deleted pages.
8. Data gaps
Based on the wiki's current coverage, suggest:
- Topics mentioned frequently but lacking depth
- Questions the wiki can't answer well
- Concepts that could be explored further with additional sources
Auto-Fix Behavior
Fix automatically without asking:
- Missing index entries (add them)
- Index entries pointing to deleted pages (remove them)
- Broken wikilinks where the target page exists under a slightly different name (fix the link)
Ask the user before fixing:
- Contradictions between pages
- Orphan pages (user may want to keep or delete them)
- Merging pages that cover overlapping topics
Report Format
Present findings grouped by severity:
Errors (must fix)
- Broken wikilinks
- Contradictions between pages
- Index entries pointing to missing pages
Warnings (should fix)
- Orphan pages with no inbound links
- Stale claims from outdated sources
- Missing pages for frequently referenced topics
Info (nice to fix)
- Potential cross-references to add
- Data gaps that could be filled
- Index entries that could be more descriptive
For each finding, include:
- What: description of the issue
- Where: the specific file(s) and line(s)
- Fix: what to do about it
After the Report
Report what was auto-fixed, then ask:
"Auto-fixed N issues (index entries, broken links). Found N warnings and N info items remaining. Want me to fix any of these?"
If the user agrees, fix the specified issues and report what changed.
Log the lint pass
## [YYYY-MM-DD] lint | Health check
Found N errors, N warnings, N info items. Auto-fixed: [list]. Remaining: [list].
When to Lint
- After every 10 ingests — catches cross-reference gaps while they're fresh
- Monthly at minimum — catches stale claims and orphan pages over time
- Before major queries — ensures the wiki is healthy before you rely on it for analysis
Related Skills
- — process new sources into wiki pages
- — ask questions against the wiki
- — discover cross-domain connections
- — generate creative prompts from wiki content