# second-brain-lint

Audits a markdown knowledge base for broken wikilinks, contradictions, and orphan pages. Delivers a prioritized health check report with suggested fixes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 installs · ★ 760
- Author: NicholasSpisak
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NicholasSpisak/second-brain/tree/HEAD/skills/second-brain-lint/SKILL.md
- Updated: 2026-04-07
- HTML: https://affpapa.org/en/nevibecode/skills/second-brain-lint

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/second-brain-lint/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/second-brain-lint/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/second-brain-lint/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/second-brain-lint/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NicholasSpisak/second-brain second-brain-lint
```

2. **Manually: put the files in place**
- File: `.github/skills/second-brain-lint/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NicholasSpisak/second-brain --path skills/second-brain-lint
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/second-brain-lint/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NicholasSpisak/second-brain/tree/HEAD/skills/second-brain-lint/SKILL.md

## When to use it
- 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.md` consistency against existing files
- record health check results into `wiki/log.md`

## Example prompts
- 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

## Similar
- [second-brain](https://affpapa.org/en/nevibecode/skills/coreyhaines31-second-brain.md) — skill · 355 installs
- [wiki-lint](https://affpapa.org/en/nevibecode/skills/wiki-lint.md) — skill · 3500 installs
- [company-brain](https://affpapa.org/en/nevibecode/skills/company-brain.md) — skill · 357 installs
- [karpathy-llm-wiki](https://affpapa.org/en/nevibecode/skills/karpathy-llm-wiki.md) — skill · 8200 installs
- [wiki-ingest](https://affpapa.org/en/nevibecode/skills/wiki-ingest.md) — skill · 3600 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/hermes-agent-llm-wiki.md) — skill · 604 installs

From the same set: [nicholasspisak/second-brain](https://affpapa.org/en/nevibecode/by/nicholasspisak/second-brain.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md