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 — macOS and Linux

$ curl -fsSL https://brains.jaimansoni.com/install.sh | sh

1. Install — Windows PowerShell

$ irm https://brains.jaimansoni.com/install.ps1 | iex

2. Browse what is available

$ brains explore

3. Install a skill

$ brains install tour-site-seo

Installing without Node

The install script uses your existing Node if it is version 18 or newer. If Node is missing or too old it downloads a private copy into ~/.brains and uses it only for this tool — nothing is installed system-wide and sudo is never required.

macOS / Linux
  ~/.brains/node        private Node runtime (only if needed)
  ~/.brains/npm         the brains-cli package
  ~/.local/bin/brains   the launcher
  uninstall: rm -rf ~/.brains ~/.local/bin/brains

Windows
  %USERPROFILE%\.brains\node    private Node runtime (only if needed)
  %USERPROFILE%\.brains\npm     the brains-cli package
  %USERPROFILE%\.brains\bin     the launcher
  uninstall: Remove-Item -Recurse -Force $env:USERPROFILE\.brains

Both installers add the launcher directory to your PATH, so open a new terminal afterwards. If you already have Node 18+ on any platform, plain npm works everywhere and skips all of this.

With npm

$ npm install -g brains-cli

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.