> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Agent skills

Drop-in instructions that teach AI coding agents how to integrate Paddle, including catalog setup, checkout, webhooks, subscription sync, pricing pages, and sandbox testing.

---

Agent skills are a standardized way to give AI agents instructions on how to integrate Paddle. They give your agent specialized knowledge and instructions for specific Paddle workflows, helping it to build integrations faster and more accurately.

{% callout type="warning" title="AI agents can make mistakes" %}
Skills make agents more accurate, not infallible. Always review the code an agent writes before merging or deploying it, especially around authentication, webhook secrets, and access gating.
{% /callout %}

## How it works

Skills tell an agent how to use Paddle in code, with framework-specific patterns, verification instructions, and best practices. They're written specifically for agents, rather than humans.

They complement the docs MCP server, which gives agents knowledge of Paddle, and the Paddle MCP server, which lets agents take actions in Paddle. Skills are deliberately short and focused, so agents know exactly what to do. They include links to the relevant docs and MCP tool calls.

Agents automatically load skills on demand when their `description` matches the task they're working on.

## Discovery and verification

Paddle publishes skills using the [agent skills discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc). This means agents should be able to automatically discover the skills when hitting `developer.paddle.com`

The RFC is still in progress, so you can ask your agent to fetch the index at:

```text
https://developer.paddle.com/.well-known/agent-skills/index.json
```

Skills are also available on GitHub at `@PaddleHQ/paddle-agent-skills`.

[Fork or clone the repo, then add the `SKILL.md` files to your agent's rules or context directory](https://github.com/PaddleHQ/paddle-agent-skills)

## Available skills

{% skills-list /%}

Each skill is self-contained, but several link to each other. For example, `paddle-subscription-sync` assumes you have `paddle-webhooks` working.

## Install in your project

### Skills CLI

The fastest way to get started is to use the skills CLI:

{% code-group sync="js-package-manager" %}

```bash {% title="pnpm" %}
pnpm dlx skills add @PaddleHQ/paddle-agent-skills
```

```bash {% title="yarn" %}
npx skills add @PaddleHQ/paddle-agent-skills
```

```bash {% title="npm" %}
npx skills add @PaddleHQ/paddle-agent-skills
```

{% /code-group %}

### Manual installation

Save each skill in the `.agents/skills` directory. For example, to install the `paddle-webhooks` skill:

```bash
mkdir -p .agents/skills # if not created
curl -fsSL https://developer.paddle.com/skills/paddle-webhooks/SKILL.md \
  -o .agents/skills/paddle-webhooks/SKILL.md
```

Repeat for each skill you want available. Claude Code loads skills on demand when their `description` matches the task you're working on.

To install all six at once:

```bash
for slug in paddle-catalog-setup paddle-checkout-web paddle-webhooks \
            paddle-subscription-sync paddle-pricing-pages paddle-sandbox-testing; do
  mkdir -p .agents/skills/$slug # if not created
  curl -fsSL https://developer.paddle.com/skills/$slug/SKILL.md \
    -o .agents/skills/$slug/SKILL.md
done
```

## Update skills

Paddle updates skills periodically as features are added or changed. Re-fetch periodically (or have your CI do it) to make sure your local copies stay current.