Second Brain
When you want to capture into, compile, query, lint, or connect your personal Second...
Install
npx skills add coreyhaines31/makerskills --skill second-brain -g -a claude-code -y- Repository
- coreyhaines31/makerskills880
- Category
- AI and agents
- Updated
- 9d ago
- License
- MIT
- Context cost
- Mediumabout 2,698 tokens
- Runs scripts
- No, instructions only
What it does
When you want to capture into, compile, query, lint, or connect your personal Second Brain. Wraps the Karpathy LLM Wiki schema (Obsidian or any markdown vault), raw/ (unprocessed sources), wiki/ (AI-compiled interlinked topic pages), outputs/ (generated artifacts). Vault defaults to ${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/. Six modes, capture (drop something into raw/), compile (process unprocessed raw files into wiki pages, update INDEX.md), query (answer a question from the wiki, save to outputs/), lint (orphans / contradictions / stale / unprocessed raw / topic gaps), connect (suggest new wikilinks between pages), search (quick lookup). Triggers on "/second-brain," "/sb," "capture this," "save this to my brain," "compile the wiki," "process raw notes," "query my wiki," "ask my brain," "lint the wiki," "find connections," "search my notes." Complements deep-research (external corpus), this is the internal corpus. Team knowledge goes to company-brain, not here.
/second-brain, Karpathy LLM Wiki workflow
Wraps an existing Second Brain in Obsidian (or any markdown-based vault). The wiki vault's schema doc (CLAUDE.md or AGENTS.md) is the authoritative schema, the skill orchestrates the operations the user has been doing manually.
Mental model
Three layers, each with a clear role:
raw/ → wiki/ → outputs/
sources compiled generated
artifacts
- raw/, unprocessed source material. Articles, highlights, ideas, braindumps, tweets. Type-prefixed (
article-,idea-,highlights-,braindump-,note-,resource-,tweet-). Never deleted, source of truth. - wiki/, AI-compiled topic pages. One page per concept, not per source. Interlinked via
[[wikilinks]].INDEX.mdat root. - outputs/, generated artifacts from queries: research summaries, analyses, slide decks. Named descriptively.
Folders to leave alone during wiki ops: Projects/, Daily/, Templates/, Inbox/, Notes/, Tasks.md, Kanban.md, Home.md.
Step 1, Load vault config + schema
- Read
references/vault-config.mdfor the vault path (default:${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/) - Read the vault's schema doc,
<vault>/CLAUDE.mdor<vault>/AGENTS.md, whichever exists (if both, read both), for the authoritative schema. If present, trust it overreferences/schema.md, the user's vault is the source of truth. - If neither exists, fall back to
references/schema.md.
