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

# Build Paddle integrations faster with agent skills and the Claude Code plugin

Agent skills give AI coding agents drop-in instructions for Paddle workflows, like catalog setup, checkout, webhooks, and subscription sync. The official Claude Code plugin installs them in one command alongside the Paddle docs MCP server.

---

## What's new?

We've released [Paddle agent skills](https://developer.paddle.com/sdks/ai/agent-skills.md), a set of drop-in instructions that teach AI coding agents how to integrate Paddle. Each skill covers a specific workflow, so your agent knows exactly what to do when you ask it to build a Paddle feature.

We've also released an official [Claude Code](https://claude.com/claude-code) plugin that installs every skill in one command and wires up the [Paddle docs MCP server](https://developer.paddle.com/sdks/ai/docs-mcp.md) at the same time.

{% callout type="warning" %}
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 are short, framework-specific patterns written for agents rather than humans. They include verification instructions, best practices, and links to the relevant docs and MCP tool calls. Agents load them on demand when a skill's `description` matches the task you're working on.

Skills sit alongside our Paddle MCP servers and play a distinct role:

- [Agent skills](https://developer.paddle.com/sdks/ai/agent-skills.md) tell agents **how to build** for Paddle, including the patterns and conventions to follow when writing integration code.
- The [Paddle docs MCP server](https://developer.paddle.com/sdks/ai/docs-mcp.md) gives agents **up-to-date knowledge** of Paddle, useful for troubleshooting and planning.
- The [Paddle MCP server](https://developer.paddle.com/sdks/ai/paddle-mcp.md) lets agents **take actions** in your Paddle account, like creating products and prices, minting client-side tokens, and simulating webhooks.

### Available skills

Ten skills are available at launch, covering the most common Paddle workflows:

{% skills-list /%}

### How skills compare

Alongside skills, we've published data on how we evaluated skills against LLMs in our [LLM benchmark](https://developer.paddle.com/llm-leaderboard.md). It's a real-world test of how well LLMs build with Paddle, and shows how skills and MCP help models do better.

Across the board, we saw that skills lift model performance an average of 13% across all models we tested. They unblock tasks that even large, frontier models couldn't do without help, and significantly improved smaller models' performance.

{% callout type="neutral" icon="carbon:favorite-filled" %}
Shoutout to the [Clerk.com](https://clerk.com) team for the inspiration for this page.
{% /callout %}

## Install using the skills CLI

For [Cursor](https://developer.paddle.com/get-started/ai/cursor.md), Windsurf, and other agent tools that support the [agent skills discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc), you can install the skills via the skills CLI:

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

```bash {% title="pnpm" %}
pnpm dlx skills add https://developer.paddle.com/
```

```bash {% title="yarn" %}
yarn dlx skills add https://developer.paddle.com/
```

```bash {% title="npm" %}
npx skills add https://developer.paddle.com/
```

{% /code-group %}

## Install in Claude Code

For [Claude Code](https://developer.paddle.com/get-started/ai/claude-code.md), the fastest way to install all the skills is via the official Paddle plugin:

```bash
/plugin marketplace add PaddleHQ/paddle-agent-skills
/plugin install paddle@paddle-agent-skills
```

The plugin installs every skill and configures the Paddle MCP servers in one step. To update later, run `/plugin marketplace update paddle-agent-skills`.

## Next steps

Agent skills and the Claude Code plugin are available now. See [agent skills](https://developer.paddle.com/sdks/ai/agent-skills.md) for the full skill list and installation options, or [build with Claude Code](https://developer.paddle.com/get-started/ai/claude-code.md) for an end-to-end walkthrough of setting up Claude Code with Paddle.