Getting Started

This guide explains how the Develocity skills marketplace is distributed and how to install it in your AI client.

How Skills Are Distributed

Develocity distributes its skills as a plugin, available through both a Claude Code and a Codex plugin marketplace served by your Develocity instance over a read-only endpoint:

https://develocity.example.com/agent/skills.git

Permissions

The skills marketplace endpoint requires an access key with the Access build data via the API and MCP permission.

You can check your permissions by visiting the /settings/access page when logged in to Develocity. For detailed instructions on generating access keys, see the Develocity API user manual.

Install the Marketplace

AI clients fetch the marketplace using standard git clone over HTTPS. Configure git to send your Develocity access key on every request to the marketplace URL:

git config --global http."https://develocity.example.com/agent/skills.git/".extraHeader \
  "Authorization: Bearer <Develocity Access Key>"

Replace https://develocity.example.com with your Develocity instance URL and <Develocity Access Key> with the access key you generated.

Then add the marketplace and install skills in your AI client:

  • Claude Code

  • Codex

  • Other (via npx skills)

Add the Develocity marketplace and install the Develocity plugin using Claude Code’s plugin commands (reference):

/plugin marketplace add https://develocity.example.com/agent/skills.git
/plugin install develocity@develocity

To manually update the plugin after a Develocity upgrade, run:

/plugin marketplace update develocity
/reload-plugins

Third-party marketplaces have auto-update disabled by default. To enable automatic updates of the Develocity plugin, run /plugin, select the Marketplaces tab, choose develocity, then select Enable auto-update (reference).

Add the marketplace using the Codex CLI (reference):

codex plugin marketplace add https://develocity.example.com/agent/skills.git

Then launch codex and run /plugins to browse the marketplace and install individual skills.

To manually update the plugin after a Develocity upgrade, run:

codex plugin marketplace upgrade develocity

For AI clients without native marketplace support, use the standalone skills CLI to add the Develocity marketplace:

npx skills add https://develocity.example.com/agent/skills.git

To manually update the installed skills after a Develocity upgrade, re-run the same add command:

npx skills add https://develocity.example.com/agent/skills.git

See the skills package documentation for the full command reference.