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-code

Installs 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

More from nicholasspisak/second-brain

All 4
1slavingia avatarprocessizeslavingia/skillsTurn a product idea into a manual-first process you can start delivering today. Use when you have an idea and want to figure out how to deliver value by hand be2.5Kskills.sh installs
2vladmdgolam avatarblender-mcpvladmdgolam/agent-skillsBlender MCP expert for scene inspection, Python scripting, GLTF export, and material/animation extraction. Activate when: (1) using Blender MCP tools (get_scene2.5Kskills.sh installs
3thananon avatarqwen-agentthananon/9arm-skillsDelegate menial, well-scoped coding tasks to a cheap Qwen-backed subagent via the `claude-9arm` command instead of burning Claude tokens/quota. Use when the wor2.5Kskills.sh installs
4chrisbanes avatarcompose-ui-testing-patternschrisbanes/skillsUse when writing or reviewing Jetpack Compose UI tests, screenshot tests, previews, semantics assertions, fake image loading, keyboard input, focus assertions, 2.5Kskills.sh installs
5apollographql avatarroverapollographql/skillsGuide for using Apollo Rover CLI to manage GraphQL schemas and federation. Use this skill when: (1) publishing or fetching subgraph/graph schemas, (2) composing2.4Kskills.sh installs
6heygen-com avatarhyperframes-read-firstheygen-com/hyperframesSTART HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned vid2.4Kskills.sh installs