brains

Docs

Brains is a registry for Claude skills. The website is for browsing and authoring; the CLI is for installing.

Getting started

1. Install the CLI

$ npm install -g brains-cli

2. Browse what is available

$ brains explore

3. Install a skill

$ brains install tour-site-seo

Where skills go

By default a skill is written to ~/.claude/skills/<slug>/, where Claude Code discovers it automatically. Pass --project to write to ./.claude/skills/<slug>/ instead, so the skill can be committed alongside the repository that needs it.

The CLI records what it wrote in ~/.brains/installed.json, so brains uninstall only removes files it created.

Commands

brains exploreBrowse the registry in an interactive list.
brains search <query>Search by name, tag, or description.
brains info <slug>Show a skill's details and file list.
brains install <slug>Install into ~/.claude/skills/<slug>/.
brains install <slug> --projectInstall into ./.claude/skills/ instead.
brains listList installed skills and their versions.
brains uninstall <slug>Remove a skill and its files.
brains create <name>Scaffold a new skill directory locally.
brains publish [dir]Publish a local skill to the registry.
brains configShow or change registry URL, token, and scope.

Publishing

A skill is a directory containing a SKILL.md with YAML front matter, plus any supporting files. name in the front matter becomes the install slug, and description is what Claude reads when deciding whether the skill applies.

my-skill/
├── SKILL.md          # required — front matter + instructions
├── references/       # optional supporting docs
│   └── guide.md
└── scripts/          # optional scripts
    └── check.mjs

Authenticate

$ brains config set token <registry-token>

Publish

$ brains publish ./my-skill

Registry API

GET/api/skillsList and search published skills
GET/api/skills/:slugSkill metadata and file list
GET/api/skills/:slug/downloadFull skill including file contents
POST/api/skillsPublish a skill (token required)
PATCH/api/skills/:slugUpdate a skill (token required)
DELETE/api/skills/:slugDelete a skill (token required)

Write endpoints authenticate with an x-api-key header.