> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Enhance your AI coding assistants with official Dodo Payments skills for seamless payment integrations, webhook handling, and billing flows.

## Overview

Agent Skills are reusable capabilities that enhance what AI coding assistants can do when working with Dodo Payments. They provide procedural knowledge and best practices that help agents accomplish specific tasks more effectively - from integrating checkout flows to setting up usage-based billing.

<Info>
  **Think of skills as plugins for your AI assistant.** They teach your agent how to implement Dodo Payments features correctly, following our recommended patterns and best practices.
</Info>

Skills work with any MCP-compatible AI agent, including:

* **Claude Code** - Anthropic's CLI coding assistant
* **OpenCode** - Open source AI coding agent
* **Cursor** - AI-first code editor
* **Other MCP clients** - Any agent supporting the skills protocol

## Available Skills

| Skill                                                                                                               | Description                                                              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [dodo-best-practices](https://github.com/dodopayments/skills/tree/main/dodo-payments/best-practices)                | Comprehensive guide to integrating Dodo Payments with best practices     |
| [webhook-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/webhook-integration)           | Setting up and handling webhooks for payment events                      |
| [subscription-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/subscription-integration) | Implementing subscription billing flows                                  |
| [checkout-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/checkout-integration)         | Creating checkout sessions and payment flows                             |
| [usage-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/usage-based-billing)           | Implementing metered billing with events and meters                      |
| [billing-sdk](https://github.com/dodopayments/skills/tree/main/dodo-payments/billing-sdk)                           | Using BillingSDK React components                                        |
| [license-keys](https://github.com/dodopayments/skills/tree/main/dodo-payments/license-keys)                         | Managing license keys for digital products                               |
| [credit-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/credit-based-billing)         | Implementing credit entitlements, balances, and metered credit deduction |

## Installation

Choose your preferred installation method based on your AI coding assistant.

<Tabs>
  <Tab title="Agent Plugin (recommended)">
    If you're using Claude Code, Codex CLI, Cursor, or OpenCode, the [Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) installs all eight skills plus both MCP servers in one step. Skills load automatically when your agent detects a relevant task.

    See the [AI Coding Agents guide](/developer-resources/build-with-ai-coding-agents) for per-agent install commands.
  </Tab>

  <Tab title="Skills CLI">
    Install skills using the universal skills CLI that works with any MCP-compatible agent:

    ```bash theme={null}
    # Install all Dodo Payments skills
    npx skills add dodopayments/skills
    ```

    Or install individual skills as needed:

    ```bash theme={null}
    # Best practices guide
    npx skills add dodopayments/skills/dodo-payments/best-practices

    # Webhook integration
    npx skills add dodopayments/skills/dodo-payments/webhook-integration

    # Subscription billing
    npx skills add dodopayments/skills/dodo-payments/subscription-integration

    # Checkout flows
    npx skills add dodopayments/skills/dodo-payments/checkout-integration

    # Usage-based billing
    npx skills add dodopayments/skills/dodo-payments/usage-based-billing

    # BillingSDK components
    npx skills add dodopayments/skills/dodo-payments/billing-sdk

    # License key management
    npx skills add dodopayments/skills/dodo-payments/license-keys

    # Credit-based billing
    npx skills add dodopayments/skills/dodo-payments/credit-based-billing
    ```

    <Tip>
      Install only the skills you need to keep your agent focused and reduce context overhead.
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    Add the Dodo Payments skills marketplace to Claude Code:

    ```bash theme={null}
    /plugin marketplace add dodopayments/skills
    ```

    Then install individual plugins:

    ```bash theme={null}
    # Install best practices
    /plugin install dodo-best-practices

    # Install webhook integration
    /plugin install webhook-integration

    # Install subscription integration
    /plugin install subscription-integration

    # Install checkout integration
    /plugin install checkout-integration

    # Install usage-based billing
    /plugin install usage-based-billing

    # Install BillingSDK
    /plugin install billing-sdk

    # Install license keys
    /plugin install license-keys

    # Install credit-based billing
    /plugin install credit-based-billing
    ```
  </Tab>

  <Tab title="OpenCode">
    Skills are automatically available when configured in your OpenCode settings. Add the Dodo Payments skills repository to your configuration:

    ```json theme={null}
    {
      "skills": {
        "repositories": [
          "dodopayments/skills"
        ]
      }
    }
    ```
  </Tab>
</Tabs>

## Using Skills

Once installed, your AI assistant can leverage these skills when you ask it to implement Dodo Payments features. Here are some example prompts:

### Best Practices

```
Help me integrate Dodo Payments into my Next.js app following best practices
```

### Webhooks

```
Set up webhook handlers for payment and subscription events
```

### Subscriptions

```
Implement a subscription flow with free trial and multiple pricing tiers
```

### Checkout

```
Create a checkout session for my SaaS product
```

### Usage-Based Billing

```
Add usage-based billing to track API calls for my AI product
```

### BillingSDK

```
Add a pricing page using BillingSDK components
```

### License Keys

```
Implement license key validation for my desktop app
```

### Credit-Based Billing

```
Set up credit entitlements and metered credit deduction for my AI product
```

## How Skills Work

Skills provide your AI assistant with:

1. **Procedural Knowledge** - Step-by-step instructions for implementing features
2. **Code Templates** - Production-ready code patterns and snippets
3. **Best Practices** - Recommended approaches for security, error handling, and UX
4. **Context Awareness** - Understanding of how different Dodo Payments features work together

When you ask your AI assistant to implement a feature, it uses the relevant skill to:

* Understand the correct implementation approach
* Generate accurate, working code
* Follow Dodo Payments conventions
* Handle edge cases and errors properly

<Note>
  Skills complement the [MCP Server](/developer-resources/mcp-server) and [Sentra](/developer-resources/sentra). Use MCP for API operations, Sentra for guided integration, and Skills for enhanced AI assistant capabilities.
</Note>

## Comparison with Other Tools

| Tool             | Purpose                        | Best For                                    |
| ---------------- | ------------------------------ | ------------------------------------------- |
| **Agent Skills** | Enhance AI assistant knowledge | AI-assisted development with any MCP client |
| **MCP Server**   | Execute API operations         | Direct API access from AI assistants        |
| **Sentra**       | Guided integration assistant   | Interactive billing integration in IDE      |

## Resources

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/dodopayments/skills">
    Browse the source code and contribute to Dodo Payments skills
  </Card>

  <Card title="MCP Server" icon="server" href="/developer-resources/mcp-server">
    Enable AI assistants to execute Dodo Payments API operations
  </Card>

  <Card title="Sentra" icon="wand-magic-sparkles" href="/developer-resources/sentra">
    AI-powered billing assistant for your IDE
  </Card>

  <Card title="Discord Community" icon="discord" href="https://discord.gg/bYqAp4ayYh">
    Get help and share feedback with the community
  </Card>
</CardGroup>