Registries

Registries let you browse and install skills or plugins beyond a single owner/repo URL. Each registry is tracked in capa’s database; the adapter is materialized under ~/.capa/registries-managed/<slug>/.

Supported types: github, gitlab, url, and claude-marketplace.

For the full lifecycle (add, refresh, disable, Web UI, Claude marketplace), see Managing registries.

Manage registries

capa registry                 # same as list
capa registry list
capa registry path            # ~/.capa/registries-managed/

capa registry add infragate/capa@skills-sh
capa registry add owner/repo::registries/internal --type gitlab
capa registry add https://example.com/adapter.ts
capa registry add owner/repo@my-reg my-reg   # explicit slug

capa registry refresh <slug>
capa registry enable <slug>
capa registry disable <slug>
capa registry remove <slug>

capa registry search <query>
capa registry search <slug> <query>
capa registry search -q design --capability skills

Full flag details: CLI: registry.

Add a registry

Choose a source
- GitHub / GitLab: owner/repo@name (search) or owner/repo::path/to/adapter (exact)
- HTTPS URL to an adapter.ts / .js / .mjs file
- Claude marketplace: see below
Install the adapter
Terminal window
```
capa registry add infragate/capa@skills-sh
```
capa derives a slug from the source (for example skills-sh). Pass a second argument to override.
Verify
Terminal window
```
capa registry list
```
Confirm the registry shows as healthy / enabled.

Install an item

capa add skills-sh:vercel-labs/skills/find-skills
capa install

Claude marketplace

Point at a marketplace repo that publishes marketplace.json (source shaped like owner/repo), and set the type explicitly:

capa registry add anthropics/claude-plugins-official my-marketplace --type claude-marketplace

Then install with the usual slug:itemId form. Browse and manage registries from the Web UI as well (Registries → Manage registries).

Install syntax

capa add <slug>:<itemId>

The registry adapter decides whether the item is a skill or a plugin. You can still pass --plugin / --skill; if they conflict with the adapter result, capa warns and follows the adapter.