# Second Brain Lint

Health-check the wiki for contradictions, orphan pages, stale claims, and missing...

- Repository: https://github.com/NicholasSpisak/second-brain (767 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-04-07
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -g -a claude-code -y`
Codex: `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -g -a codex -y`
Cursor: `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -g -a cursor -y`
Gemini CLI: `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

```bash
# 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

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

### 7. Index consistency

The rest: https://github.com/NicholasSpisak/second-brain/blob/HEAD/skills/second-brain-lint/SKILL.md