Skip to content

registry

Registries let you browse and install skills/plugins from adapters (for example skills.sh, Claude marketplaces, or internal catalogs). Adapters are materialized under ~/.capa/registries-managed/.

Synopsis

capa registry
capa registry list
capa registry path
capa registry add <source> [slug] [--type <type>] [--no-cache]
capa registry remove <slug>
capa registry refresh <slug> [--no-cache]
capa registry enable <slug>
capa registry disable <slug>
capa registry search [slug] [query] [-q <query>] [-c <capability>] [-l <n>]

Running capa registry with no subcommand is the same as capa registry list.

Subcommands

Command	Description
`list`	List configured registries (status, type, source)
`path`	Print the managed registries directory
`add <source> [slug]`	Fetch and install a registry adapter
`remove <slug>`	Delete the registry row and materialized adapter
`refresh <slug>`	Re-fetch the adapter from its stored source
`enable <slug>`	Re-enable a disabled registry
`disable <slug>`	Hide a registry without removing it
`search [slug] [query]`	Search skills/plugins (omit slug to search all enabled registries)

`registry add` flags

Flag	Description
`--type <type>`	Source type: `github`, `gitlab`, `url`, or `claude-marketplace` (auto-detected from the source by default)
`--no-cache`	Bypass the on-disk repo cache when fetching

`registry refresh` flags

Flag	Description
`--no-cache`	Bypass the on-disk repo cache when refreshing

`registry search` flags

Flag	Description
`-q`, `--query <query>`	Search query (alternative to the positional query)
`-c`, `--capability <capability>`	Restrict to `skills` or `plugins`
`-l`, `--limit <n>`	Max results per registry

Source forms for `add`

Form	Example
GitHub search	`capa registry add infragate/capa@skills-sh`
GitHub exact path	`capa registry add owner/repo::registries/internal`
GitLab	`capa registry add gitlab/group/proj::registries/internal --type gitlab`
HTTPS URL	`capa registry add https://example.com/adapter.ts`
Claude marketplace	`capa registry add <source> --type claude-marketplace`
Explicit slug	`capa registry add owner/repo@my-reg my-reg`

Examples

capa registry list
capa registry path

capa registry add infragate/capa@skills-sh
capa registry add https://example.com/adapter.ts --type url
capa registry refresh skills-sh --no-cache
capa registry disable skills-sh
capa registry enable skills-sh
capa registry remove skills-sh

capa registry search "find skills"
capa registry search skills-sh "vercel" -c skills -l 10
capa registry search -q "frontend" -c plugins

# Install an item from a registry
capa add skills-sh:vercel-labs/skills/find-skills

See also