coreyhaines31/makerskills / skills/second-brain
second-brain
VerifiedWhen 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.7 KB |
| references/schema.md | markdown | 7.3 KB |
| references/templates/raw.md | markdown | 341 B |
| references/templates/wiki.md | markdown | 611 B |
| references/vault-config.md | markdown | 1.8 KB |
references/vault-config.md
View on GitHub# Vault config
The Second Brain vault location and tool.
| Field | Value |
|---|---|
| **Path** | `${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/` |
| **Tool** | Obsidian (markdown-based) |
| **Schema source** | `<path>/CLAUDE.md` or `<path>/AGENTS.md` (authoritative — always read first) |
| **Backup** | _not configured here — assumes vault is in iCloud/Dropbox/git_ |
## Folders
| Folder | Purpose | Modifiable by `second-brain`? |
|---|---|---|
| `raw/` | Unprocessed source material | ✅ create files |
| `wiki/` | Compiled topic pages | ✅ create + update files |
| `wiki/INDEX.md` | Master index | ✅ update |
| `outputs/` | Generated artifacts (queries, slide decks, briefs) | ✅ create files |
| `Inbox/` | Quick-capture inbox | ❌ off-limits — `Quick Capture.md` is for raw thoughts before they hit `raw/` |
| `Projects/` | Project-specific notes | ❌ off-limits — `project-manager` skill territory |
| `Daily/` | Daily notes | ❌ off-limits |
| `Templates/` | Note templates | ❌ off-limits |
| `Notes/` | Misc | ❌ off-limits |
| `Tasks.md` | Task list | ❌ off-limits |
| `Kanban.md` | Personal kanban | ❌ off-limits — `project-manager` skill territory |
| `Home.md` | Vault home | ❌ off-limits |
## Switching vaults
If the user moves the vault or wants to use a different setup (Logseq, plain markdown dir, Notion):
1. Update **Path** above
2. If the tool changes, note any structural differences (e.g., Logseq uses `journals/` and `pages/`)
3. Ensure the new vault has a `CLAUDE.md`, `AGENTS.md`, or other schema doc the skill can read at Step 1
## Note
The skill always reads `<vault>/CLAUDE.md` or `<vault>/AGENTS.md` at start. If the user updates their schema there, the skill picks it up automatically — no need to keep this skill's `schema.md` in sync.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |