
Second Brain Lint
Runs a comprehensive health check across your personal wiki to catch broken wikilinks, orphaned pages with no inbound references, contradictions between sources, and missing cross-references that should exist. It scans for stale claims from outdated sources, suggests topics that warrant their own pages, and verifies your index stays in sync with actual files. The report groups findings by severity with specific file locations and actionable fixes, then offers to apply them automatically. Run this after every ten ingests to catch problems early, or monthly to prevent your second brain from rotting. The contradiction detection is the standout feature here, genuinely useful for avoiding the trap of accumulating conflicting information over time without realizing it.
- skills.sh installs
- 2.5K
- GitHub stars
- 774
- last updated
- Aug 21, 2026
Install
$ npx -y skills add nicholasspisak/second-brain --skill second-brain-lint --agent claude-codeInstalls into .claude/skills of the current project.
Files
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.
# Find all wikilinks across wiki pages
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
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
Sponsors
Details
- Repository
- github.com/nicholasspisak/second-brain
- Categories
- Documentation, Code Review & Quality
- First seen
- Apr 16, 2026