Second Brain Lint

1---2name: second-brain-lint3description: >4  Health-check the wiki for contradictions, orphan pages, stale claims,5  and missing cross-references. Use when the user says "audit",6  "health check", "lint", "find problems", or wants to improve wiki quality.7allowed-tools: Bash Read Write Edit Glob Grep8---9 10# Second Brain — Lint11 12Health-check the wiki and report issues with actionable fixes.13 14## Audit Steps15 16Run all checks below, then present a consolidated report.17 18### 1. Broken wikilinks19 20Scan all wiki pages for `[[wikilink]]` references. For each link, verify the target page exists. Report any broken links.21 22```bash23# Find all wikilinks across wiki pages24grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u25```26 27Cross-reference against actual files in `wiki/`.28 29### 2. Orphan pages30 31Find pages with no inbound links — no other page references them via `[[wikilink]]`.32 33For each `.md` file in `wiki/sources/`, `wiki/entities/`, `wiki/concepts/`, `wiki/synthesis/`:34- Extract the page name (filename without extension)35- Search all other wiki pages for `[[Page Name]]`36- If no other page links to it, it's an orphan37 38### 3. Contradictions39 40Read pages that share entities or concepts and look for conflicting claims. Flag when:41- Two source summaries make opposing claims about the same topic42- An entity page contains information that conflicts with a source summary43- Dates, figures, or factual claims differ between pages44 45### 4. Stale claims46 47Cross-reference source dates with wiki content. Flag when:48- A concept page cites only old sources and newer sources exist on the same topic49- Entity information hasn't been updated despite newer sources mentioning that entity50 51### 5. Missing pages52 53Scan 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.54 55### 6. Missing cross-references56 57Find pages that discuss the same topics but don't link to each other. Look for:58- Entity pages that mention concepts without linking them59- Concept pages that mention entities without linking them60- Source summaries that cover the same topic but don't reference each other61 62### 7. Index consistency63 64Verify `wiki/index.md` is complete and accurate:65- Every page in `wiki/sources/`, `wiki/entities/`, `wiki/concepts/`, `wiki/synthesis/` has an index entry66- No index entries point to deleted pages67- Entries are under the correct category header68 69### 8. Data gaps70 71Based on the wiki's current coverage, suggest:72- Topics mentioned frequently but lacking depth73- Questions the wiki can't answer well74- Areas where a web search could fill in missing information75 76## Report Format77 78Present findings grouped by severity:79 80### Errors (must fix)81- Broken wikilinks82- Contradictions between pages83- Index entries pointing to missing pages84 85### Warnings (should fix)86- Orphan pages with no inbound links87- Stale claims from outdated sources88- Missing pages for frequently referenced topics89 90### Info (nice to fix)91- Potential cross-references to add92- Data gaps that could be filled93- Index entries that could be more descriptive94 95For each finding, include:96- **What:** description of the issue97- **Where:** the specific file(s) and line(s)98- **Fix:** what to do about it99 100## After the Report101 102Ask the user:103> "Found N errors, N warnings, and N info items. Want me to fix any of these?"104 105If the user agrees, fix issues and report what changed.106 107## Log the lint pass108 109Append to `wiki/log.md`:110 111    ## [YYYY-MM-DD] lint | Health check112    Found N errors, N warnings, N info items. Fixed: [list of fixes applied].113 114## When to Lint115 116- **After every 10 ingests** — catches cross-reference gaps while they're fresh117- **Monthly at minimum** — catches stale claims and orphan pages over time118- **Before major queries** — ensures the wiki is healthy before you rely on it for analysis119 120## Related Skills121 122- `/second-brain-ingest` — process new sources into wiki pages123- `/second-brain-query` — ask questions against the wiki