Second Brain Ingest
Turns raw sources dropped into a vault into source, concept and entity pages that are linked in both directions, with index and log updated in the same run.
Docs & OfficeIntermediate★ 288⑂ 50AI score 8/10Last updated: Sep 23, 2026
What it does
- Reads the source completely (file in
raw/, pasted article, transcript, PDF) before writing, then creates a source page inwiki/sources/recording claims as claims with attribution. - Searches the existing vault first, so ingesting into a 300-page vault mostly updates pages instead of duplicating them; contradictions are recorded side by side rather than overwritten.
- Enforces the core rule "nothing is ingested until it is linked": source → concepts/entities and back again, with missing targets either created or listed under Gaps in
index.md. - Updates
index.mdand appends tolog.mdin the same run, then prints a fixed report (new pages, updated pages, links added, contradictions, gaps). - Includes calibration guidance so one article yields one to three real concepts, not ten restated paragraphs.
Who it's for
- Obsidian / markdown wiki and Zettelkasten users running a personal knowledge vault.
- Researchers and writers whose clipped articles pile up unlinked and unfindable.
- Anyone who wants consistent, auditable note ingestion instead of ad-hoc summaries.
Examples
- Drop
raw/karpathy-llm-wiki.mdand say "ingest this" → one source page, new[[LLM wiki]]concept,[[Andrej Karpathy]]entity, updates to[[Obsidian]]and[[Claude Code]], 11 links added. - Paste a conference transcript and say "add this to my second brain" → only the one to three durable ideas become their own pages; the rest stays inside the source page.
- Ask "catch up on unprocessed sources" → each raw file is ingested in turn and every run is appended to
log.md.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/undefined-ui/second-brain-os/HEAD/skills/second-brain-ingest/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/second-brain-ingest folder from the GitHub repo undefined-ui/second-brain-os into my ~/.claude/skills/second-brain-ingest/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/undefined-ui/second-brain-os.git && mkdir -p ~/.claude/skills && cp -r second-brain-os/skills/second-brain-ingest ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/undefined-ui/second-brain-os.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r second-brain-os/skills/second-brain-ingest ~/.claude/skills/ - Make sure your vault has
raw/,wiki/sources/,index.mdandlog.md— create them if missing. - Run
claudefrom inside your vault directory, drop a file intoraw/, and say "ingest this" to trigger the skill. - Commit or back up the vault before the first run so you can diff the reported new/updated pages.
View source on GitHub ↗License: MIT