Agent Skills

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.

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.

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

Gemini CLI is the exception. It has no agent-skill primitive, so skills are not available there—only the two MCP servers are.

Available Skills

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

Getting Started

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

Accepting Payments

Skill	Description
checkout-integration	Checkout Sessions, payment links, and overlay or inline checkout
subscription-integration	Subscription lifecycle, trials, plan changes, proration, and on-demand charges
mobile-checkout	In-app checkout for React Native, Flutter, iOS, and Android
webhook-integration	Receiving and verifying webhooks using the Standard Webhooks specification

Billing Models

Skill	Description
credit-based-billing	Credit entitlements, balances, ledger, rollover, overage, and meter-based deduction
usage-based-billing	Meters, event ingestion, aggregation, and per-unit pricing
license-keys	License key activation, validation, and instance management

Catalog and Pricing

Skill	Description
product-catalog-management	Products, pricing, add-ons, collections, images, and digital product delivery
discounts-and-promotions	Discount codes, eligibility rules, stacking, and subscription-cycle limits
localized-pricing	Localized pricing, adaptive currency, and purchasing power parity

Customers and Operations

Skill	Description
customer-management	Customers, the self-service portal, saved payment methods, and wallets
refunds-and-disputes	Issuing refunds, handling disputes and chargebacks, and reconciling access

UI and Integrations

Skill	Description
billing-sdk	BillingSDK React components for pricing tables and billing UI
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.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

The Dodo Agent Plugin 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 for per-agent install commands.

Install skills using the universal skills CLI that works with any agent that supports skills:

# Install all Dodo Payments skills
npx skills add dodopayments/skills

Or install individual skills as needed:

# 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

Install only the skills you need to keep your agent focused and reduce context overhead.

Add the Dodo Payments skills marketplace to Claude Code:

/plugin marketplace add dodopayments/skills

Then install individual plugins:

# 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

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:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$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.

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

opencode run "List every skill available to you by name."

You should see all seventeen.

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:

Procedural Knowledge — Step-by-step instructions for implementing features
Code Templates — Production-ready code patterns and snippets
Best Practices — Recommended approaches for security, error handling, and UX
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.

Skills complement the MCP Server. Use MCP for API operations and Skills for enhanced AI assistant capabilities.

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

Skills Repository

Browse the source code and contribute to Dodo Payments skills

MCP Server

Enable AI assistants to execute Dodo Payments API operations

Build with AI Coding Agents

Install the Agent Plugin: all skills plus both MCP servers in one step

Discord Community

Get help and share feedback with the community

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Available Skills

Getting Started

Accepting Payments

Billing Models

Catalog and Pricing

Customers and Operations

UI and Integrations

Installation

Using Skills

How Skills Work

Comparison with Other Tools

Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​Overview

​Available Skills

​Getting Started

​Accepting Payments

​Billing Models

​Catalog and Pricing

​Customers and Operations

​UI and Integrations

​Installation

​Using Skills

​How Skills Work

​Comparison with Other Tools

​Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

Overview

Available Skills

Getting Started

Accepting Payments

Billing Models

Catalog and Pricing

Customers and Operations

UI and Integrations

Installation

Using Skills

How Skills Work

Comparison with Other Tools

Resources