Getting Started

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

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 agents 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 agent:

  • 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 Develocity marketplace and install the Develocity plugin using the Codex CLI (reference):

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

Codex installs plugins as a whole, so this makes every Develocity skill available at once. Run codex plugin list to see what is installed.

To manually update the plugin after a Develocity upgrade, refresh the marketplace snapshot and reinstall the plugin:

codex plugin marketplace upgrade develocity
codex plugin add develocity@develocity

Refreshing the snapshot on its own leaves the installed plugin at its previous version.

For AI agents 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.