second-brain
Skill0 starsChanged 7 days agoMITView on GitHub
Entry point and router for any request about the second brain vault. Work out what the owner wants and run the right flow (capture, ingest, query, lint, repair, project, brain-review, gap-finder, setup), chaining several when needed. Use when a request is vague or spans several steps ("deal with my inbox", "add this and tell me how it fits", "what should I do next?", "help me with my notes", "/second-brain"), when it's unclear which flow applies, or at the start of a session in this vault.
26 other projects use a version of this.
Adopted by
Most recently taken up by
- 0xsarwagya/agent-skills-alycdtheir own version, first seen Nov 8, 2026
- DaraBoth/skilljmskilltheir own version, first seen Nov 8, 2026
- dmitrax/second-brain-setuptheir own version, first seen Nov 7, 2026
- gaetanbaudime-dot/Claude-skilltheir own version, first seen Nov 1, 2026
- luizsiqueira-eng/skillstheir own version, first seen Oct 20, 2026
- alycd/agent-skillstheir own version, first seen Oct 20, 2026
Used with
Projects with it also use weekly-review.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
QuixiAISkillweekly-review
Review the past week across goals, tasks, calendar, journal, and commitments, then propose the next week
Also in 3 projects that use this
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 26
- coreyhaines31/makerskills★ 916same name
- NicholasSpisak/second-brain★ 718same name
- uussnn/second-brain★ 82same name
- sean-esk/second-brain-gtd★ 48same name
- calebnewtonusc/Chewbacca★ 8same name
- stancsz/second-brain★ 7same name
- josherau/claude-operating-core★ 3same name
- DaraBoth/skilljmskill★ 2same name
- dmitrax/second-brain-setup★ 2same name
- Dressi123/second-brain-skill★ 2same name
16 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 22 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
If you haven't done it this session, do the session-start reading: 90-system/about.md, index.md, and the tail of log.md (grep "^## \[" …
- Distinctive: line 42
Ambiguous?: Ask one short question with the 2 most likely flows as options, e.g.
- Distinctive: line 70
If a step fails or is blocked, stop the chain, report where you stopped and why, and offer to resume.
- Distinctive: line 75
Use the snapshot from §1 and propose the top 1-3 actions, highest first:
- Very specific: line 86
Read .agents/skills/<flow>/SKILL.md in full (or invoke the skill by name if your tool supports it).
- Distinctive: line 87
Follow it exactly: its steps, check-ins, self-check, and hard constraints override anything here.
- Distinctive: line 88
When a flow finishes, either continue the announced chain or end with one suggested next step (e.g.
“Common” is measured: kept by at least 6 in 10 of the 22 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Second Brain: router
You don't do the work here. You decide which flow runs, in what order, and then follow that flow's
SKILL.md exactly. Rules live in AGENTS.md; procedures live in .agents/skills/<flow>/SKILL.md.
1. Orient (cheap, every time)
- If you haven't done it this session, do the session-start reading:
90-system/about.md,index.md, and the tail oflog.md(grep "^## \[" log.md | tail -10). - Snapshot the vault state (one command; no page reads):
echo "inbox: $(find 00-inbox -type f ! -name .gitkeep | wc -l)"; \ echo "last lint: $(grep '^## \[.*\] lint' log.md | tail -1)"; \ echo "last review: $(grep '^## \[.*\] review' log.md | tail -1)"; \ echo "indexed pages: $(grep -c '^- \[\[' index.md)"; \ grep -q '^- Role / work: *$' 90-system/about.md && echo "profile: EMPTY" || echo "profile: ok" - Once per session, run
scripts/qmd-sync.shto pick up edits the owner made outside the agent (Obsidian, journal). It's a no-op without qmd and embeds in the background.
2. Classify the request
Match on intent, not keywords. Pick the first row that fits.
| The owner wants to… | Signals | Flow |
| Set up or change how the brain knows them | "set up", "onboard", "update my profile", role change; or profile EMPTY and the request isn't urgent | setup |
| Keep something for later | URL, pasted text/transcript/idea, "save", "clip", "remember this" (with no "process" or "add to wiki") | capture |
| Turn material into knowledge | "ingest", "process", "file this", "add to my brain/wiki", a path in 00-inbox/ | ingest |
| Learn something from the vault | a question; "what do I know", "compare", "summarize my notes", "why did we…" | query |
| Keep a good answer | "file that back", "save this as a page" (right after a query) | query §5 (file-back) |
| Know if the vault is healthy | "lint", "check", "audit", "what's broken", "clean up" (no specific item) | lint |
| Fix specific problems | "fix 1-3", "merge X and Y", "fix broken links", approves lint items | repair |
| Work on a project | project name from index.md › Projects, "start/update/close project", "where are we on X", "log what we did" | project |
| Step back | "review", "what's on my plate", "what did I miss", "plan my week", "process my journal" | brain-review |
| Grow the knowledge | "what should I read next", "knowledge gaps", "what's missing", "find sources for X" | gap-finder |
| Nothing specific | "what should I do?", "help with my brain", bare /second-brain | §4 Suggest |
Ambiguous? Ask one short question with the 2 most likely flows as options, e.g. "Save it to the inbox for later, or ingest it into the wiki now?" Don't ask when the default below applies.
Defaults when unsure:
- URL or pasted content with no verb →
capture, then offer ingest. - A question that the vault clearly doesn't cover (nothing in
index.md) → say so in one line and answer asquerywith a large Gaps section. Offer tocapturesources on it. - "Clean up" with a lint report less than 7 days old →
repairproposal from that report; otherwiselint.
3. Chain flows (multi-step requests)
Split compound requests into flows and run them in sequence, each to completion (including its own check-ins and log entry) before starting the next. Announce the chain first in one line: "Plan: capture → ingest → query. Starting with capture."
Common chains:
| Request | Chain |
| "Add this article and tell me how it fits" | capture → ingest → query ("how does X relate to what I know?") |
| "Process my inbox" (N items) | ingest × N, one at a time, oldest first, a check-in per source unless auto |
| "Clean up the vault" | lint → (owner picks items) → repair |
| "Weekly maintenance" | brain-review → lint → then offer ingest for the inbox |
| "Research X for project Y" | query → file-back → project update (link the synthesis in the project log) |
| "Start project X based on my notes" | query (context on X) → project start (pre-fill the brief, then interview) |
| "Find and add sources on my gaps" | gap-finder → (owner picks gaps + sources) → capture → ingest × N |
Chaining rules:
- Stop at every owner decision point (ingest check-in, lint → repair, file-back, brief edits). Never treat the chain's announcement as approval for the gated steps.
- If a step fails or is blocked, stop the chain, report where you stopped and why, and offer to resume.
- More than 5 inbox items or more than 3 flows: confirm scope first ("12 items in the inbox. Do all, or the 3 oldest?").
4. Suggest (when there's no clear request)
Use the snapshot from §1 and propose the top 1-3 actions, highest first:
- Profile EMPTY →
setup. - Inbox has items →
ingest(name the oldest 1-3 with their age). - Last lint more than 30 days ago (or never, and the index has 10+ pages) →
lint. - Last review more than 7 days ago →
brain-review. - Active project with no log entry for more than 14 days →
projectresume. - Otherwise →
gap-finder(what to read next for the current focus), or aqueryon the current focus.
Present them as a short numbered list and ask which to run.
5. Hand off
- Read
.agents/skills/<flow>/SKILL.mdin full (or invoke the skill by name if your tool supports it). - Follow it exactly: its steps, check-ins, self-check, and hard constraints override anything here.
- When a flow finishes, either continue the announced chain or end with one suggested next step (e.g. after ingest: "Ask a question across these sources?"; after lint: "Say fix 1-3").
Hard constraints
- The router itself writes nothing except through a flow. No direct wiki edits "on the way".
- One flow at a time; every flow logs its own entry. The router adds no extra log lines.
AGENTS.md§6 hard rules apply throughout.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

