# Second Brain

> >

- **Type:** Skill
- **Install:** `agentstack add skill-surajgthakkar-agent-skills-second-brain`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SurajGThakkar](https://agentstack.voostack.com/s/surajgthakkar)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SurajGThakkar](https://github.com/SurajGThakkar)
- **Source:** https://github.com/SurajGThakkar/agent-skills/tree/main/skills/knowledge-management/second-brain

## Install

```sh
agentstack add skill-surajgthakkar-agent-skills-second-brain
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Second Brain

Bootstrap, maintain, or operate an LLM-managed personal wiki using the [LLM Wiki at Scale](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) pattern. The LLM incrementally builds a persistent, interlinked wiki from raw sources — knowledge compiled once, kept current, compounding with every ingest.

Three branches. Read the disclosed file before executing.

---

## Shared Rules

- **TaskCreate visible.** Use TaskCreate to make stages visible to the user on every branch.
- **Scripts propose, LLM disposes.** Deterministic scripts hand clean worklists; the LLM exercises judgment. Never blind-apply script output.
- **Anti-bleed rule.** "Lean" applies ONLY to operational files (AGENTS.md, playbooks, scripts). Content generation — ingestion, entity extraction, concept pages — must be *relentless*: sprawling, exhaustive, granular. A rich source spawns 10-15 pages. If you produce one summary page, you are committing premature completion and stranding knowledge. The schema is lean so the *content* can be massive.
- **Handoff.** Day-to-day ingest and query run through the vault's own AGENTS.md (or CLAUDE.md) playbooks once live — not this skill.

---

## Branch: Setup

**When:** User wants a new vault, or to continue a partial bootstrap.
**Read:** `references/setup.md`
**Completion:** Every phase (Discovery → Scaffold → Interview → Inject → Build → Orient) completed. Zero `{...}` placeholders remaining in generated files. User oriented with core commands and a suggested first action.

---

## Branch: Maintain

**When:** User asks to lint, health-check, rebuild index, rotate logs, calibrate confidence, or normalize tags.
**Read:** `references/maintenance.md`
**Completion:** Lint loop exits with zero criticals. Index rebuilt. Log entry appended. Every worklist item accepted, modified, or declined by the user.

---

## Branch: Operate

**When:** User wants to build or schedule an autonomous wiki-maintenance Operator.
**Read:** `references/operator.md`
**Completion:** Operator prompt saved with zero `{{...}}` placeholders. Schedule wired via the schedule skill. User told the cadence and how to manage the trigger.
**Scope:** Pure wiki upkeep, scheduled and unattended — lint, the three safe fixers, index rebuild, log rotation, source-queue and scratch visibility — run locally against the vault with no external connectors and no MCP. It never resolves judgment calls (broken links, contradictions, tag drift) and never auto-ingests; both stay queued for a supervised session. Optionally researches open questions into `raw/scratch/` for later review — never into `wiki/`, and off by default.

---

## Reference Files

Progressive disclosure — load only for the active branch or on demand.

| File | Purpose | Branch |
|------|---------|--------|
| `references/setup.md` | Full setup workflow (Phases 0–E) | Setup |
| `references/maintenance.md` | Lint loop, script table, fix patterns | Maintain |
| `references/operator.md` | Operator build + schedule (Phases 0–4) | Operate |
| `references/AGENTS-template.md` | Schema template for new vaults | Setup |
| `references/llm-wiki-at-scale.md` | Architecture philosophy | Any (on demand) |
| `references/playbooks/*.md` | Vault playbook templates | Setup |
| `references/formats/*.md` | Page/index/log/tag format specs | Setup |
| `references/operator-prompt-template.md` | Rendered wiki-maintenance operator prompt | Operate |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SurajGThakkar](https://github.com/SurajGThakkar)
- **Source:** [SurajGThakkar/agent-skills](https://github.com/SurajGThakkar/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-surajgthakkar-agent-skills-second-brain
- Seller: https://agentstack.voostack.com/s/surajgthakkar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.