A skill is a markdown file that teaches an agent a procedure: how to design something
before building it, how to research a company, how to verify a page with a real browser,
how to document an incident.
They are protocol-level, so they work on any brain with any model. Install one, and the
agent knows a way of working it did not know before.
Install
# as a Claude Code plugin marketplace
/plugin marketplace add giobi/claude-skills
/plugin install design
# or with the /brain package manager, inside any brain
/brain install design
# or by hand — one folder, no build step
curl -sL https://brainprotocol.it/skills/design/design.zip -o /tmp/design.zip
unzip -o /tmp/design.zip -d .claude/skills/
Using something other than Claude Code? Hit copy prompt on any
skill below and paste it into your agent. It points at a page that tells the agent how to fetch
the skill and what to do with it — including what changes when there is no brain around it.
Builds shared understanding before anyone writes anything. It grills you one question at a time until the concept holds in three sentences, captures the vocabulary as it surfaces — the words you and the agent are using differently without noticing — and settles the system into a few deep modules with narrow interfaces. The output is a design.md a future session can read cold.
Implements those modules under two constraints at once: TDD for the rhythm (one test, one implementation, no code without a test that demands it) and deep modules for the structure — you design the interface, the agent may write the implementation. After each area it asks whether the module can be delegated now, then loops back to update design.md so the map stays alive.
Run one session as the conductor of the other live Claude sessions in tmux: register them, delegate with the right provider, relay decisions, check RAM before every open, and know when to send the user to the dedicated session instead
A skill is a folder with a SKILL.md. The frontmatter is the whole contract:
a name, a one-line description the agent matches on, and whether a human can invoke it.
Everything after it is plain markdown — when to use it, when not to, the workflow,
the fallbacks when a companion skill is missing.
Write it in English, including the name: a skill name is an address, and addresses do not
get translated. Keep the "when not to use this" section honest — it is what stops an agent
reaching for the wrong tool.