second-brain-lint — Claude Code skill: what it does, how to install
Audits a markdown knowledge base for broken wikilinks, contradictions, and orphan pages. Delivers a prioritized health check report with suggested fixes.
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-codeWhat second-brain-lint does
The skill inspects markdown notes stored under wiki/ to pinpoint broken [[wikilink]] targets, orphaned files lacking incoming links, and conflicting statements across sources. It flags date discrepancies or diverging factual claims between concept documents and entity summaries.
It relies on Bash, Grep, Glob, Read, Write, and Edit to inspect directories such as wiki/sources/, wiki/entities/, and wiki/concepts/. The audit also verifies files against wiki/index.md to ensure index integrity and highlights mentioned subjects that lack dedicated pages.
Because the routine hardcodes paths to specific subdirectories, running it against an unorganized markdown repository will produce false errors. Once the inspection finishes, the agent asks for confirmation to apply fixes and appends an entry to wiki/log.md.
What it helps with
- find broken
[[wikilink]]references across markdown notes - detect orphan documentation files with no inbound links
- flag factual contradictions between concepts and entity summaries
- verify
wiki/index.mdconsistency against existing files - record health check results into
wiki/log.md
Example prompts for the agent
- Run a health check on my wiki and report broken links
- Audit the second brain for orphan pages and stale claims
- Check wiki/index.md for consistency and find contradictions
How to install second-brain-lint
1Skills CLI (Vercel)
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-code2Manually: put the files in place
~/.claude/skills/second-brain-lint/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/second-brain-lint/
1Skills CLI (Vercel)
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a codex2Manually: put the files in place
.agents/skills/second-brain-lint/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a cursor2Manually: put the files in place
.cursor/skills/second-brain-lint/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NicholasSpisak/second-brain second-brain-lint2Manually: put the files in place
.github/skills/second-brain-lint/SKILL.md1Skills CLI (Vercel)
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a gemini-cli2Platform CLI
gemini skills install https://github.com/NicholasSpisak/second-brain --path skills/second-brain-lintManually: put the files in place
.devin/skills/second-brain-lint/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about second-brain-lint
How to install second-brain-lint in Claude Code?
Run npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-code. The skill file will be placed in ~/.claude/skills/second-brain-lint/SKILL.md.
What issues does second-brain-lint detect?
It spots broken wikilinks, orphan notes without backlinks, outdated claims, and factual conflicts across files. It also checks for index mismatches and missing pages.
What folder structure does the skill require?
It expects a root wiki/ directory containing sources/, entities/, concepts/, and synthesis/ folders. It also relies on wiki/index.md for index verification and wiki/log.md for recording check passes.
