---
component: ROOT
version: "2026.2"
slug: ROOT/integrations/getting-started
canonical_url: "https://docs.gradle.com/develocity/2026.2/integrations/agentic-ai/skills/getting-started/"
title: "Getting Started"
description: "Install the Develocity skills marketplace in your AI client, configure access-key authentication, and verify access to the published skills."
keywords:
  - "API"
  - "installation"
status: current
---

<!-- llms-index: https://docs.gradle.com/develocity/llms.txt -->

# Getting Started

<a id="preamble"></a>

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

<a id="how-skills-are-distributed"></a>

## 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
```

<a id="permissions"></a>

## 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](https://docs.gradle.com/develocity/2026.2/reference/develocity-api/#creating-access-keys).

<a id="install-the-marketplace"></a>

## 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:

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

Replace `[https://develocity.example.com](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:

<a id="tabs-1"></a>

*   <a id="tabs-1-claude-code"></a>
    
    Claude Code
    
*   <a id="tabs-1-codex"></a>
    
    Codex
    
*   <a id="tabs-1-other-via-npx-skills"></a>
    
    Other (via `npx skills`)
    

<a id="tabs-1-claude-code--panel"></a>

Add the Develocity marketplace and install the Develocity plugin using Claude Code’s plugin commands ([reference](https://code.claude.com/docs/en/discover-plugins)):

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

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

```shell
/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](https://code.claude.com/docs/en/discover-plugins#configure-auto-updates)).

<a id="tabs-1-codex--panel"></a>

Add the marketplace using the Codex CLI ([reference](https://developers.openai.com/codex/cli/reference)):

```shell
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:

```shell
codex plugin marketplace upgrade develocity
```

<a id="tabs-1-other-via-npx-skills--panel"></a>

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

```shell
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:

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

See the [`skills` package documentation](https://www.npmjs.com/package/skills) for the full command reference.