# second-brain-ingest

This skill turns raw documents in raw/ into linked wiki pages. Useful when you keep clipping articles and notes into one folder.

- 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-ingest/SKILL.md
- Updated: 2026-04-07
- HTML: https://affpapa.org/en/nevibecode/skills/second-brain-ingest

## What it does

The skill walks the files in `raw/` and builds a summary page in `wiki/sources/` for each one. It reads the whole source first, then shows you the 3-5 main takeaways and waits for your confirmation — nothing gets written before that. The summary page holds a structured overview, key claims, and the entities and concepts the source mentions.

From there it updates the entity and concept pages: people, organizations and products go to `wiki/entities/`, ideas and frameworks to `wiki/concepts/`. If a page already exists, the skill appends the new material and adds the source to the `sources:` field. When fresh information contradicts what is already there, it edits the page and flags the contradiction with both sources cited. Cross-references use `[[wikilinks]]` rather than file paths.

Finally it updates `wiki/index.md` and `wiki/log.md`. The log is what makes repeat runs safe: files already listed there are skipped, so you can drop in a new article and run the skill again. One source usually touches 10-15 wiki pages, which is expected. Note that the skill only works on files you have already placed in `raw/` — with no such folder there is nothing to process.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NicholasSpisak/second-brain --skill second-brain-ingest -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-ingest/SKILL.md

## When to use it
- file a downloaded article into the wiki
- spot files in `raw/` that were never ingested
- link a new entity to pages where it already appears
- record a contradiction between a new source and an older note
- refresh the index and log after adding material

## Example prompts
- process the new sources in raw/
- ingest this article, I dropped it into raw/
- go through this file and tell me what matters in it

## Similar
- [second-brain](https://affpapa.org/en/nevibecode/skills/coreyhaines31-second-brain.md) — skill · 355 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/ar9av-llm-wiki.md) — skill · 4100 installs
- [wiki-ingest](https://affpapa.org/en/nevibecode/skills/wiki-ingest.md) — skill · 3600 installs
- [company-brain](https://affpapa.org/en/nevibecode/skills/company-brain.md) — skill · 357 installs
- [firecrawl-knowledge-ingest](https://affpapa.org/en/nevibecode/skills/firecrawl-knowledge-ingest.md) — skill · 31400 installs
- [karpathy-llm-wiki](https://affpapa.org/en/nevibecode/skills/karpathy-llm-wiki.md) — skill · 8200 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