# Skills 1 skills library for every agent: find what each agent can see, install once, keep a backup. Canonical: https://brainplane.app/docs/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 ``` ## 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.