Agent Skills

Overview

Agent Skills são recursos reutilizáveis que ampliam o que os assistentes de codificação com IA podem fazer ao trabalhar com o Dodo Payments. Eles fornecem conhecimento procedural e práticas recomendadas que ajudam os agentes a realizar tarefas específicas com mais eficiência — desde a integração de fluxos de checkout até a configuração de cobrança baseada em uso.

Pense nas skills como plugins para seu assistente de IA. Elas ensinam seu agente a implementar os recursos do Dodo Payments corretamente, seguindo padrões recomendados e práticas recomendadas.

As skills funcionam com qualquer agente de IA compatível com o protocolo de skills, incluindo:

Claude Code — assistente de codificação CLI da Anthropic
Codex CLI — agente de codificação CLI da OpenAI
Cursor — editor de código com IA em primeiro lugar
VS Code / GitHub Copilot — por meio do Agent Plugin
Kiro — carrega skills como um Power
OpenCode — agente de codificação com IA de código aberto
Outros clientes — qualquer agente compatível com o protocolo de skills

Gemini CLI é a exceção. Ele não possui uma primitiva de agent-skill, portanto as skills não estão disponíveis nele — apenas os dois MCP servers.

Skills disponíveis

Dezessete skills que abrangem toda a superfície de integração, agrupadas de acordo com a tarefa que você está realizando.

Primeiros passos

Skill	Descrição
dodo-best-practices	Configuração do SDK, ambientes, chaves de API e a arquitetura canônica de checkout a webhook
framework-adapters	Handlers de rota `@dodopayments/*` oficiais para Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun e Convex
testing-and-go-live	Modo de teste, métodos de pagamento de teste, testes de webhook e checklist de lançamento em produção

Aceitando pagamentos

Skill	Descrição
checkout-integration	Checkout Sessions, links de pagamento e checkout overlay ou inline
subscription-integration	Ciclo de vida de assinaturas, testes, alterações de planos, rateio proporcional e cobranças sob demanda
mobile-checkout	Checkout no aplicativo para React Native, Flutter, iOS e Android
webhook-integration	Recebimento e verificação de webhooks usando a especificação Standard Webhooks

Modelos de cobrança

Skill	Descrição
credit-based-billing	Entitlements de créditos, saldos, ledger, rollover, excedentes e dedução baseada em medição
usage-based-billing	Meters, ingestão de eventos, agregação e preços por unidade
license-keys	Ativação e validação de chaves de licença e gerenciamento de instâncias

Catálogo e preços

Skill	Descrição
product-catalog-management	Produtos, preços, complementos, coleções, imagens e entrega de produtos digitais
discounts-and-promotions	Códigos de desconto, regras de elegibilidade, combinação de descontos e limites por ciclo de assinatura
localized-pricing	Preços localizados, Adaptive Currency e paridade do poder de compra

Clientes e operações

Skill	Descrição
customer-management	Clientes, portal de autoatendimento, métodos de pagamento salvos e carteiras
refunds-and-disputes	Emissão de reembolsos, gerenciamento de disputas e chargebacks e reconciliação de acesso

UI e integrações

Skill	Descrição
billing-sdk	Componentes React do BillingSDK para tabelas de preços e UI de cobrança
better-auth-integration	Plugin `@dodopayments/better-auth` para sincronização de clientes, checkout e acesso ao portal

Instalação

Escolha seu método de instalação preferido com base no seu assistente de programação com IA.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

O Dodo Agent Plugin instala todas as dezessete skills e os dois MCP servers em uma única etapa para Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. As skills são carregadas automaticamente quando seu agente detecta uma tarefa relevante.Consulte o guia de AI Coding Agents para ver os comandos de instalação específicos de cada agente.

Instale as skills usando a CLI universal de skills, que funciona com qualquer agente compatível com skills:

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

Ou instale skills individuais conforme necessário:

# 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

Instale apenas as skills necessárias para manter seu agente focado e reduzir a sobrecarga de contexto.

Adicione o marketplace de skills do Dodo Payments ao Claude Code:

/plugin marketplace add dodopayments/skills

Em seguida, instale plugins individuais:

# 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

O OpenCode carrega skills de diretórios indicados por você. Ele não verifica pacotes instalados, portanto uma entrada explícita skills.paths é necessária.Usando o pacote Agent Plugin:

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"]
  }
}

Os caminhos relativos são resolvidos em relação ao diretório do projeto, portanto o pacote deve estar presente no node_modules desse projeto. Um caminho absoluto também funciona e evita a necessidade de instalação local.

Um caminho de skills que não existe é ignorado silenciosamente — sem erro ou aviso. Confirme se as skills foram realmente carregadas:

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

Você deverá ver todas as dezessete.

Usando Skills

Depois de instaladas, seu assistente de IA carrega automaticamente a skill relevante quando você solicita a implementação de um recurso do Dodo Payments. Você não precisa informar o nome da skill; basta descrever a tarefa.

Exemplo de prompt	Skill carregada
Ajude-me a integrar o Dodo Payments ao meu app Next.js seguindo as práticas recomendadas	`dodo-best-practices`
Adicione um handler de rota de checkout do Dodo Payments ao meu app Hono	`framework-adapters`
Explique passo a passo como testar pagamentos e entrar em produção	`testing-and-go-live`
Crie uma sessão de checkout para meu produto SaaS	`checkout-integration`
Implemente um fluxo de assinatura com período de teste gratuito e várias faixas de preço	`subscription-integration`
Adicione checkout no app ao meu app React Native	`mobile-checkout`
Configure handlers de webhook para eventos de pagamento e assinatura	`webhook-integration`
Configure entitlements de crédito e dedução de créditos medidos para meu produto de IA	`credit-based-billing`
Adicione cobrança baseada em uso para acompanhar chamadas de API do meu produto de IA	`usage-based-billing`
Implemente a validação de chaves de licença para meu app desktop	`license-keys`
Crie um catálogo de produtos com add-ons e preços por faixa	`product-catalog-management`
Adicione um código promocional que ofereça 20% de desconto nos três primeiros ciclos de cobrança	`discounts-and-promotions`
Mostre os preços na moeda local do visitante com paridade de poder de compra	`localized-pricing`
Ofereça aos clientes um portal self-service para gerenciar seus métodos de pagamento	`customer-management`
Emita um reembolso parcial e revogue o acesso quando uma contestação for aberta	`refunds-and-disputes`
Adicione uma página de preços usando componentes do BillingSDK	`billing-sdk`
Integre o Dodo Payments à minha configuração do Better Auth	`better-auth-integration`

Como as Skills Funcionam

As skills fornecem ao seu assistente de IA:

Conhecimento procedural — instruções passo a passo para implementar recursos
Modelos de código — padrões e snippets de código prontos para produção
Práticas recomendadas — abordagens recomendadas para segurança, tratamento de erros e UX
Consciência de contexto — compreensão de como os diferentes recursos do Dodo Payments funcionam em conjunto

Quando você solicita ao seu assistente de IA a implementação de um recurso, ele usa a skill relevante para entender a abordagem correta de implementação, gerar código funcional e preciso, seguir as convenções do Dodo Payments e tratar adequadamente casos extremos e erros.

As skills complementam o MCP Server. Use MCP para operações de API e Skills para aprimorar os recursos do assistente de IA.

Comparação com Outras Ferramentas

Ferramenta	Finalidade	Melhor para
Agent Skills	Ampliar o conhecimento do assistente de IA	Desenvolvimento assistido por IA com qualquer agente compatível com skills
MCP Server	Executar operações de API	Acesso direto à API por assistentes de IA

Recursos

Skills Repository

Navegue pelo código-fonte e contribua com as skills do Dodo Payments

MCP Server

Permita que assistentes de IA executem operações de API do Dodo Payments

Build with AI Coding Agents

Instale o Agent Plugin: todas as skills e os dois MCP servers em uma única etapa

Discord Community

Obtenha ajuda e compartilhe feedback com a comunidade

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Skills disponíveis

Primeiros passos

Aceitando pagamentos

Modelos de cobrança

Catálogo e preços

Clientes e operações

UI e integrações

Instalação

Usando Skills

Como as Skills Funcionam

Comparação com Outras Ferramentas

Recursos

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​Overview

​Skills disponíveis

​Primeiros passos

​Aceitando pagamentos

​Modelos de cobrança

​Catálogo e preços

​Clientes e operações

​UI e integrações

​Instalação

​Usando Skills

​Como as Skills Funcionam

​Comparação com Outras Ferramentas

​Recursos

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

Overview

Skills disponíveis

Primeiros passos

Aceitando pagamentos

Modelos de cobrança

Catálogo e preços

Clientes e operações

UI e integrações

Instalação

Usando Skills

Como as Skills Funcionam

Comparação com Outras Ferramentas

Recursos