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).

The Codex plugin marketplace is not available in this version of Develocity. codex plugin marketplace add reports success, but Codex cannot resolve the Develocity plugin from the marketplace, so codex plugin add fails.

Install the skills with the skills CLI instead, as described in the Other tab. Codex reads the skills that the CLI installs, so all Develocity skills become available.

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

This installs the skills for the current project only, under .agents/skills in the working directory. Add -g to install them for your user account instead, so they are available in every project:

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

To manually update the installed skills after a Develocity upgrade, re-run the add command you used, keeping -g if you installed for your user account:

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

See the skills package documentation for the full command reference.