Skills

What a skill is

A skill is a written procedure your agents can follow, such as reviewing a contract or filing invoices. brainplane lists, read-only, the skills it finds in each agent's skill folders and in folders you add: your own, public libraries, third-party and the ones agents ship with.

For each skill it shows which agent can see it, which can run it, and any problem, such as a description cut short or a duplicate name.

Your own skills

brainplane reads them where they are and never edits the originals. Make it work everywhere installs 1 copy in a shared folder that Claude Code, Codex and Grok all read. Before anything changes you see the diff. The current version goes to a backup folder first, and you can undo for 24 hours.

Public libraries

brainplane can follow a public library on GitHub. It compares what you have installed with the library and updates on your press, from a pinned and reviewed version. It shows every changed file first.

New skills

The New skill helper asks what the skill should do and which past session it should learn from. That session's own agent writes the draft: brainplane never reads your session history itself. brainplane checks the draft, then a dry run shows what the skill would do.

Run a skill

brainplane runs a skill's steps as handoffs, with a gate before each step that needs you and a receipt for each step:

bp skills run <skill>

What a skill can never do

Any step that sends, pays, submits a form, invites someone or creates an account belongs to you. brainplane shows 1 card that says what to press and where, then waits. A skill that gives such a step to an agent is refused when brainplane builds it.