Save to brain
Overview
Files knowledge into the user's markdown vault(s). Each vault's AGENTS.md is the single source of truth for layout, frontmatter, workflows, commits and what may be stored. This skill only finds the right vault and hands off to it. Don't carry conventions over from memory or from another vault.
Steps
- Find the vaults. Look for vault paths and routing rules in the global
CLAUDE.mdalready in context (a "brain" pointer or a "Knowledge bases" table). If none is there, ask the user for the vault path. Don't guess. - Read the target vault's
AGENTS.mdandindex.mdbefore writing. If a page already covers the topic, extend it. - Pick the content.
- If the arguments name a topic or source, run that vault workflow (guide, research, idea or ingest) on it.
- Otherwise, take what's worth keeping from this session: setups that worked, gotchas, findings, ideas. Write one page per distinct topic.
- Route each page using the
CLAUDE.mdrules. If one topic mixes general and client-specific knowledge, split it: the general part goes to the personal vault, and the specifics go to the client vault. - Finish each page with that vault's "Every change" steps, and run git with
git -C <vault>. - Report:
- the pages created or updated in each vault, with their paths
- the commits, and whether they were pushed
- anything deliberately left out, and why
Quick reference
| User says | Do |
|---|---|
| "save this to the brain" | Session content, routed per CLAUDE.md |
/save-to-brain guide |
Guide from this session's work |
/save-to-brain research <topic> |
Run the vault's Research workflow on the topic |
/save-to-brain idea <pitch> |
Idea page in the personal vault |
/save-to-brain ingest <url> |
The vault's Ingest workflow |
| Several things at once ("guide for X, plus that idea") | One page and one commit per item, each routed separately |