skilld
All skills
coreyhaines31 avatar

/second-brain

@4e84cbe
by Corey Hainescoreyhaines31/makerskills839 stars
69

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). Tool-agnostic in design but defaults to a vault at ${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.

Requires /deep-research /jab-hook

Ask your Agent

Use this Skill: https://skilld.dev/gh/coreyhaines31/makerskills/second-brain

This session only. Nothing lands on disk.

referencesvault-config.md

≈430 tokens on demand. Your agent reads this file only when SKILL.md points to it.

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 (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 — pm 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 — pm 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 or schema doc the skill can read at Step 1

Note

The skill always reads <vault>/CLAUDE.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.

Source: SKILL.md on GitHub

Third-party checks

1 warning1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill manages a local markdown-based knowledge vault. It includes functionality to capture web content and render documents using external tools like Pandoc. The primary security considerations involve the ingestion of untrusted external data and the use of shell commands for document processing.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 4e84cbe. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 weeks ago.

Activeupdated last month

Capability

metadata
{
  "version": "0.2.0"
}

README badge

README badge for coreyhaines31/makerskills/second-brain