Convert a Claude Code marketplace
Turn an existing Claude Code marketplace repository into a Skillcrew registry with one command.
GuidesOn 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_asalias,<plugin>-<name>; - blocks skills that fail validation;
- and the command prints what
skillcrew validatefinds, 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-reviewUse --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
skillspaths inplugin.jsonormarketplace.jsonare not followed.skillcrew validatewarns about such plugins.
Then
- Set real statuses: make your baseline
requiredorrecommended. See Statuses. - Run
skillcrew validateuntil it passes. - Add the CI check: Validate in CI.
- Commit, push, and share
skillcrew init <registry>with your developers.