Skip to content
Skills Library
Personal productivity · Building & coding

brain

/brain

Use when creating or editing anything in the second brain vault - a new folder or structure, a repo/project page, a documentation note, a slash command, a commit, a task or todo, a hook, a plan, or a decision (ADR), including promoting captured decisions from the ledger. Also use when asked to record a decision, log a session, or write something into the vault. Triggers on "/brain new", "/brain edit", "add this to the brain", "record this decision", "document this".

Licence
GPL-3.0
Last repository change
13.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

GPL-3.0, otwarta.

What it does and when to use it

Use when creating or editing anything in the second brain vault - a new folder or structure, a repo/project page, a documentation note, a slash command, a commit, a task or todo, a hook, a plan, or a decision (ADR), including promoting captured decisions from the ledger. Also use when asked to record a decision, log a session, or write something into the vault. Triggers on "/brain new", "/brain edit", "add this to the brain", "record this decision", "document this".

Triggers from the description

add this to the brainrecord this decisiondocument this
Original author description

Use when creating or editing anything in the second brain vault - a new folder or structure, a repo/project page, a documentation note, a slash command, a commit, a task or todo, a hook, a plan, or a decision (ADR), including promoting captured decisions from the ledger. Also use when asked to record a decision, log a session, or write something into the vault. Triggers on "/brain new", "/brain edit", "add this to the brain", "record this decision", "document this".

How it works

  1. Before writing anything
  2. Kinds
  3. Always, for every kind
Original SKILL.md headings · 46 lines, 260 words
SKILL.md preview
---
name: brain
description: Use when creating or editing anything in the second brain vault - a new folder or structure, a repo/project page, a documentation note, a slash command, a commit, a task or todo, a hook, a plan, or a decision (ADR), including promoting captured decisions from the ledger. Also use when asked to record a decision, log a session, or write something into the vault. Triggers on "/brain new", "/brain edit", "add this to the brain", "record this decision", "document this".
---

# brain

Router for writing to the second brain. Its path is `vault` in the machine's config:
`bun --bun ~/.claude/hooks/skeleton-config.mjs vault`.

```
/brain new  <kind> [name]
/brain edit <kind> [name]
```

## Before writing anything

1. Read `00-Meta/Conventions.md` — frontmatter schema, naming, where things live.
2. Read `00-Meta/Hard-Rules.md` if the change touches code, deps, components, or licensing.
3. Check the target doesn't already exist: `ctx_search`, or `graphify query`.

**Never duplicate a repo's own docs into the vault.** A repo's `docs/` *is* its documentation;
vault pages link inward.

## Kinds

Load **only** the reference file for the kind being invoked. Do not read the others.

| kind | reference |
|---|---|
| `structure` | `references/structure.md` |
| `repo` | `references/repo.md` |
| `docs` | `references/docs.md` |
| `command` | `references/command.md` |
| `commit` | `references/commit.md` |
| `task` | `references/task.md` |
| `hook` | `references/hook.md` |
| `plan` | `references/plan.md` |
| `decision` | `references/decision.md` — also `/brain new decision --ledger` |

If the kind is ambiguous, ask — do not guess between `docs` and `repo`.

## Always, for every kind

- Frontmatter on every note. `type` and `created` required; `updated` on every edit.
- Wikilinks `[[name]]` for cross-references. A markdown path link is invisible to the graph.
- Link the new note from its folder MOC, or it is unreachable at retrieval tier 1.
- After a batch of changes, `bun --bun ~/.claude/hooks/brain-graph.mjs` in the vault — free, AST only; not a bare `graphify update .`, which drops cross-folder links.
- Commit the way `00-Meta/Hard-Rules.md` says to branch and commit.
Files in this package (10)
  • SKILL.md 2 KB
  • references/command.md 1 KB
  • references/commit.md 1 KB
  • references/decision.md 2 KB
  • references/docs.md 1 KB
  • references/hook.md 1 KB
  • references/plan.md 1 KB
  • references/repo.md 2 KB
  • references/structure.md 1 KB
  • references/task.md 1 KB

Versions

RepositoryScoreLicence
This page · atlasatakahraman/knowledge-skeleton100GPL-3.0
jeremylongshore/tons-of-skills-marketplace100MIT
coco-research/coco100MIT
jeremylongshore/bobs-big-brain-registrar100Apache-2.0
onetest-ai/echo100AGPL-3.0
johantor/brain100Apache-2.0
guangshinhaha/shinstack100MIT
kayossouza/brain-template100MIT
keli-wen/agy-staff95MIT

Database snapshot: 13.11.2026 · package version c85e3cc48507 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100second-brain
    Use when the user wants to capture something into their second brain or personal notes vault ("remember that…", "add this idea", "log this", "note to self", "journal"), asks a question their own context would answer ("what are my goals", "what did I decide about X", "what's the…
  • 100brain-sync
    Use when the user asks to update their second brain from a chat, to sync new learnings into the brain repo, to process brain Inbox, or after a meaningful conversation that should become lasting notes. Also use for /brain sync or "این چت رو به brain ببر".
  • 100second-brain-ingest
    Turn raw source material in a second-brain vault into linked wiki pages: read the source, split it into concepts and entities, write or update pages, connect them to existing pages, and record the run in the log. Use this skill whenever the user drops a file into raw/, pastes an…
  • 100new-project
    Create a new project folder inside a brain (projects/<name>/ with AGENTS.md, CLAUDE.md and PROGRESS.md, plus a row in the brain's index), then commit and push. Use only after the user has said yes to turning a request into a new project, or when the user explicitly asks to…
  • 100init
    Create a new vault from the kit's templates — folders, CLAUDE.md schema, hot cache, index, log and settings — in an empty folder or an existing Obsidian vault, without overwriting anything; then fill the identity card and point to the Obsidian setup. Use when the user asks to…
  • 1003d-brain
    Use when someone asks to build a 3D brain, visualize their AIOS or second brain, turn their knowledge into an interactive graph, or run /3d-brain or /3D brain.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.