Command Reference

brainbase skill

Install, update, and publish skills. See Skills for the source grammar and the registry.

brainbase skill add <source>

Install a skill from GitHub, a generic git URL, the Brainbase registry, or a local path. Rename it on install with --as.

The source string determines where the skill is fetched from. A bare owner/repo is GitHub short-form (not the registry); use the brainbase:// scheme to pull from the registry. Pin a version inside the source string rather than with a flag.

Source form	Fetched from
`owner/repo`	GitHub short-form.
`owner/repo@ref`	GitHub at a branch or tag.
`github:owner/repo/sub/path[@ref]`	GitHub with a subpath.
`https://github.com/owner/repo/tree/REF/sub`	GitHub tree URL.
`https://gitlab.com/...`, `git@host:...`, `git+<url>`	Generic git (there is no `git:` scheme).
`brainbase://creator/slug@version`	Brainbase skill registry.

bash

brainbase skill add owner/repo
brainbase skill add github:owner/repo/path/to/skill@v1.2.0
brainbase skill add brainbase://acme/pdf-extract@1.2.0 --as my-skill

Flag	Description
`--as <slug>`	Install under a different slug.
`--scope <s>`	`global` or `project`.
`--harness <id>`	Target harness.

brainbase skill list

Show locally installed skills and the source each was fetched from.

bash

brainbase skill list

brainbase skill update <slug>

Re-fetch a skill from its recorded source.

bash

brainbase skill update pdf-extract

brainbase skill remove <slug>

Uninstall a skill.

bash

brainbase skill remove pdf-extract

brainbase skill search [query]

Search the Brainbase skill registry. Filter by category or agent harness, and page through results with --page.

bash

brainbase skill search "pdf"
brainbase skill search --category devtools --agent claude-code
brainbase skill search --page 2

Flag	Description
`--category <c>`	Filter by registry category.
`--agent <harness>`	Filter by agent harness.
`--page <n>`	Results page (1-based).

brainbase skill info <creator/slug>

Show registry details for a skill.

bash

brainbase skill info acme/pdf-extract

brainbase skill publish [dir]

Publish a SKILL.md folder to the registry. Defaults to the current directory.

bash

brainbase skill publish
brainbase skill publish ./my-skill --name acme/pdf-extract --skill-version 1.2.0 --visibility public

Flag	Description
`--name <creator/slug>`	Published name in the registry.
`--skill-version <MAJOR.MINOR.PATCH>`	Version to publish.
`--visibility <v>`	`public`, `unlisted`, or `private`.
`--harness <id>`	Target harness.
`--yes`, `-y`	Skip confirmation.

Required for non-interactive publishes

--name and --skill-version are required when --yes is passed.