| name | second-brain-lint |
| description | Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references. Use when the user says "audit", "health check", "lint", "find problems", or wants to improve wiki quality.
|
| allowed-tools | Bash Read Write Edit Glob Grep |
Second Brain — Lint
Health-check the wiki and report issues with actionable fixes.
Audit Steps
Run all checks below, then present a consolidated report.
1. Broken wikilinks
Scan all wiki pages for [[wikilink]] references.
For each link, verify the target page exists.
Report any broken links.
grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u
Cross-reference against actual files in wiki/.
2. Orphan pages
Find pages with no inbound links — no other page references them via [[wikilink]].
For each .md file in wiki/sources/, wiki/entities/, wiki/concepts/, wiki/synthesis/:
- Extract the page name (filename without extension)
- Search all other wiki pages for
[[Page Name]]
- If no other page links to it, it's an orphan
3. Contradictions
Look for conflicting claims between related pages.
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
Do not read all page pairs.
If qmd is installed, for each entity/concept page run qmd search "<page title>" --path wiki/ and cross-read only the top ~5 hits that are not already wikilinked from that page.
Fallback without qmd: restrict pair-reads to pages sharing a frontmatter tag.
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 [[wikilinks]] 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
Use the same qmd candidate search as check 3 to find related-but-unlinked pages without O(n²) reads.
7. Index consistency
Verify wiki/index.md is complete and accurate:
- Every page in
wiki/sources/, wiki/entities/, wiki/concepts/, wiki/synthesis/ has an index entry
- No index entries point to deleted pages
- Entries are under the correct category header
8. Data gaps
Based on the wiki's current coverage, suggest:
- Topics mentioned frequently but lacking depth
- Questions the wiki can't answer well
- Areas where a web search could fill in missing information
9. Un-deepened high-value pages
List light-ingested source pages and rank them as deepen candidates:
grep -l '^ingest: light' wiki/sources/*.md
Rank by (a) highlight count in the page, (b) inbound wikilink count (grep -rc '\[\[Page Title\]\]' wiki/).
Report the top 5 as "suggest /second-brain-ingest deepen".
10. Junk entities
Find entity pages whose names fail the author-name heuristic — all digits, domain-like, letterless.
Propose deletion plus the matching index and log cleanup.
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
Ask the user:
"Found N errors, N warnings, and N info items.
Want me to fix any of these?"
If the user agrees, fix issues and report what changed.
Log the lint pass
Append to wiki/log.md:
## [YYYY-MM-DD] lint | Health check
Found N errors, N warnings, N info items. Fixed: [list of fixes applied].
When to Lint
Two modes:
- Quick lint — automatic at the end of every batch ingest.
Cheap mechanical checks only: broken wikilinks (1), index consistency (7), junk-entity scan (10), and a log↔raw detection round-trip (the unprocessed-file diff from
/second-brain-ingest must be empty right after a batch).
If qmd is installed, also run qmd update so new pages are searchable.
- Full lint — monthly, on demand, or before major synthesis.
All checks including contradictions, stale claims, and deepen candidates.
Related Skills
/second-brain-ingest — process new sources into wiki pages/second-brain-query — ask questions against the wiki
