Skip to content
Skillcrew
Menu / Guides

Convert a Claude Code marketplace

Turn an existing Claude Code marketplace repository into a Skillcrew registry with one command.

View as Markdown
On this page

A Skillcrew registry is a Claude Code marketplace plus a skillcrew.yaml. If your organization already has a marketplace, you only add the governance file; the repository keeps working in Claude Code.

Run registry init inside the marketplace

terminal
$ cd acme-marketplace
$ skillcrew registry init --org acme
Converted the Claude Code marketplace into a Skillcrew registry.
  + skillcrew.yaml
  ! plugin "remote" is hosted outside the registry and is ignored
  ! skills named "review" collide; install_as installs frontend:review as frontend-review, security:review as security-review
Edit skillcrew.yaml to set statuses and teams, then commit and push.

The generated skillcrew.yaml:

  • lists every skill as available, so nothing is installed until you decide;
  • gives colliding skills an install_as alias, <plugin>-<name>;
  • blocks skills that fail validation;
  • and the command prints what skillcrew validate finds, so you know what is left to fix.
yaml
org: acme

default: available

skills:
  frontend:review:
    status: available
    install_as: frontend-review
  security:review:
    status: available
    install_as: security-review

Use --force to overwrite an existing skillcrew.yaml.

What is not converted

Skillcrew distributes skills only:

  • Plugins hosted outside the repository (github, url, npm… sources) are ignored with a warning. Copy their skills into the registry with a pull request if you need them.
  • Commands, agents, hooks and MCP servers of your plugins are ignored, and custom skills paths in plugin.json or marketplace.json are not followed. skillcrew validate warns about such plugins.

Then

  1. Set real statuses: make your baseline required or recommended. See Statuses.
  2. Run skillcrew validate until it passes.
  3. Add the CI check: Validate in CI.
  4. Commit, push, and share skillcrew init <registry> with your developers.

Type to search the documentation.