> ## 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 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 recommended patterns and best practices.
</Info>

Skills work with any AI agent that supports the skills protocol, including:

* **Claude Code** — Anthropic's CLI coding assistant
* **Codex CLI** — OpenAI's CLI coding agent
* **Cursor** — AI-first code editor
* **VS Code / GitHub Copilot** — via the Agent Plugin
* **Kiro** — loads skills as a Power
* **OpenCode** — open source AI coding agent
* **Other clients** — any agent supporting the skills protocol

<Note>
  **Gemini CLI is the exception.** It has no agent-skill primitive, so skills are not available there—only the two [MCP servers](/developer-resources/mcp-server) are.
</Note>

## Available Skills

Seventeen skills covering the full integration surface, grouped by the task you're working on.

### Getting Started

| Skill | Description |
| - | - |
| [dodo-best-practices](https://github.com/dodopayments/skills/tree/main/dodo-payments/dodo-best-practices) | SDK setup, environments, API keys, and the canonical checkout-to-webhook architecture |
| [framework-adapters](https://github.com/dodopayments/skills/tree/main/dodo-payments/framework-adapters) | Official `@dodopayments/*` route handlers for Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun, and Convex |
| [testing-and-go-live](https://github.com/dodopayments/skills/tree/main/dodo-payments/testing-and-go-live) | Test mode, test payment methods, webhook testing, and the production launch checklist |

### Accepting Payments

| Skill | Description |
| - | - |
| [checkout-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/checkout-integration) | Checkout Sessions, payment links, and overlay or inline checkout |
| [subscription-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/subscription-integration) | Subscription lifecycle, trials, plan changes, proration, and on-demand charges |
| [mobile-checkout](https://github.com/dodopayments/skills/tree/main/dodo-payments/mobile-checkout) | In-app checkout for React Native, Flutter, iOS, and Android |
| [webhook-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/webhook-integration) | Receiving and verifying webhooks using the Standard Webhooks specification |

### Billing Models

| Skill | Description |
| - | - |
| [credit-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/credit-based-billing) | Credit entitlements, balances, ledger, rollover, overage, and meter-based deduction |
| [usage-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/usage-based-billing) | Meters, event ingestion, aggregation, and per-unit pricing |
| [license-keys](https://github.com/dodopayments/skills/tree/main/dodo-payments/license-keys) | License key activation, validation, and instance management |

### Catalog and Pricing

| Skill | Description |
| - | - |
| [product-catalog-management](https://github.com/dodopayments/skills/tree/main/dodo-payments/product-catalog-management) | Products, pricing, add-ons, collections, images, and digital product delivery |
| [discounts-and-promotions](https://github.com/dodopayments/skills/tree/main/dodo-payments/discounts-and-promotions) | Discount codes, eligibility rules, stacking, and subscription-cycle limits |
| [localized-pricing](https://github.com/dodopayments/skills/tree/main/dodo-payments/localized-pricing) | Localized pricing, adaptive currency, and purchasing power parity |

### Customers and Operations

| Skill | Description |
| - | - |
| [customer-management](https://github.com/dodopayments/skills/tree/main/dodo-payments/customer-management) | Customers, the self-service portal, saved payment methods, and wallets |
| [refunds-and-disputes](https://github.com/dodopayments/skills/tree/main/dodo-payments/refunds-and-disputes) | Issuing refunds, handling disputes and chargebacks, and reconciling access |

### UI and Integrations

| Skill | Description |
| - | - |
| [billing-sdk](https://github.com/dodopayments/skills/tree/main/dodo-payments/billing-sdk) | BillingSDK React components for pricing tables and billing UI |
| [better-auth-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/better-auth-integration) | The `@dodopayments/better-auth` plugin for customer sync, checkout, and portal access |

## Installation

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

<Tabs>
  <Tab title="Agent Plugin (recommended)">
    The [Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) installs all seventeen skills plus both MCP servers in one step for Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, and OpenCode. 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 agent that supports skills:

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

    Or install individual skills as needed:

    ```bash expandable theme={null}
    # Getting started
    npx skills add dodopayments/skills/dodo-payments/dodo-best-practices
    npx skills add dodopayments/skills/dodo-payments/framework-adapters
    npx skills add dodopayments/skills/dodo-payments/testing-and-go-live

    # Accepting payments
    npx skills add dodopayments/skills/dodo-payments/checkout-integration
    npx skills add dodopayments/skills/dodo-payments/subscription-integration
    npx skills add dodopayments/skills/dodo-payments/mobile-checkout
    npx skills add dodopayments/skills/dodo-payments/webhook-integration

    # Billing models
    npx skills add dodopayments/skills/dodo-payments/credit-based-billing
    npx skills add dodopayments/skills/dodo-payments/usage-based-billing
    npx skills add dodopayments/skills/dodo-payments/license-keys

    # Catalog and pricing
    npx skills add dodopayments/skills/dodo-payments/product-catalog-management
    npx skills add dodopayments/skills/dodo-payments/discounts-and-promotions
    npx skills add dodopayments/skills/dodo-payments/localized-pricing

    # Customers and operations
    npx skills add dodopayments/skills/dodo-payments/customer-management
    npx skills add dodopayments/skills/dodo-payments/refunds-and-disputes

    # UI and integrations
    npx skills add dodopayments/skills/dodo-payments/billing-sdk
    npx skills add dodopayments/skills/dodo-payments/better-auth-integration
    ```

    <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 expandable theme={null}
    # Getting started
    /plugin install dodo-best-practices
    /plugin install framework-adapters
    /plugin install testing-and-go-live

    # Accepting payments
    /plugin install checkout-integration
    /plugin install subscription-integration
    /plugin install mobile-checkout
    /plugin install webhook-integration

    # Billing models
    /plugin install credit-based-billing
    /plugin install usage-based-billing
    /plugin install license-keys

    # Catalog and pricing
    /plugin install product-catalog-management
    /plugin install discounts-and-promotions
    /plugin install localized-pricing

    # Customers and operations
    /plugin install customer-management
    /plugin install refunds-and-disputes

    # UI and integrations
    /plugin install billing-sdk
    /plugin install better-auth-integration
    ```
  </Tab>

  <Tab title="OpenCode">
    OpenCode loads skills from directories you point it at. It does **not** scan installed packages, so an explicit `skills.paths` entry is required.

    Using the Agent Plugin package:

    ```bash theme={null}
    npm install --save-dev @dodopayments/opencode-plugin
    ```

    ```json theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "plugin": ["@dodopayments/opencode-plugin"],
      "skills": {
        "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
      }
    }
    ```

    Relative paths resolve against the **project directory**, so the package must be present in that project's `node_modules`. An absolute path works too, and avoids the local-install requirement.

    <Warning>
      A skills path that does not exist is ignored **silently** — no error, no warning. Confirm the skills actually loaded:

      ```bash theme={null}
      opencode run "List every skill available to you by name."
      ```

      You should see all seventeen.
    </Warning>
  </Tab>
</Tabs>

## Using Skills

Once installed, your AI assistant loads the relevant skill automatically when you ask it to implement a Dodo Payments feature. You don't need to name the skill; describe the task instead.

| Example prompt | Skill that loads |
| - | - |
| Help me integrate Dodo Payments into my Next.js app following best practices | `dodo-best-practices` |
| Add a Dodo Payments checkout route handler to my Hono app | `framework-adapters` |
| Walk me through testing payments and going live | `testing-and-go-live` |
| Create a checkout session for my SaaS product | `checkout-integration` |
| Implement a subscription flow with a free trial and multiple pricing tiers | `subscription-integration` |
| Add in-app checkout to my React Native app | `mobile-checkout` |
| Set up webhook handlers for payment and subscription events | `webhook-integration` |
| Set up credit entitlements and metered credit deduction for my AI product | `credit-based-billing` |
| Add usage-based billing to track API calls for my AI product | `usage-based-billing` |
| Implement license key validation for my desktop app | `license-keys` |
| Create a product catalog with add-ons and tiered pricing | `product-catalog-management` |
| Add a promo code that gives 20% off the first three billing cycles | `discounts-and-promotions` |
| Show prices in the visitor's local currency with purchasing power parity | `localized-pricing` |
| Give customers a self-service portal to manage their payment methods | `customer-management` |
| Issue a partial refund and revoke access when a dispute is opened | `refunds-and-disputes` |
| Add a pricing page using BillingSDK components | `billing-sdk` |
| Wire Dodo Payments into my Better Auth setup | `better-auth-integration` |

## 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, and handle edge cases and errors properly.

<Note>
  Skills complement the [MCP Server](/developer-resources/mcp-server). Use MCP for API operations 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 agent that supports skills |
| **MCP Server** | Execute API operations | Direct API access from AI assistants |

## 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="Build with AI Coding Agents" icon="robot" href="/developer-resources/build-with-ai-coding-agents">
    Install the Agent Plugin: all skills plus both MCP servers in one step
  </Card>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.