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 our recommended patterns and best practices.

Las skills funcionan con cualquier agente de IA compatible con el protocolo de skills, incluidos:

Claude Code - asistente de programación CLI de Anthropic
Codex CLI - agente de programación CLI de OpenAI
Cursor - editor de código centrado en la IA
VS Code / GitHub Copilot - mediante el Agent Plugin
Kiro - carga las skills como una Power
OpenCode - agente de programación de IA de código abierto
Otros clientes - cualquier agente compatible con el protocolo de skills

Gemini CLI es la excepción. No tiene una primitiva de agent-skill, por lo que las skills no están disponibles allí; solo lo están los dos servidores MCP.

Skills disponibles

Diecisiete skills que cubren toda la superficie de integración, agrupadas según la tarea en la que estés trabajando.

Primeros pasos

Skill	Descripción
dodo-best-practices	Configuración del SDK, entornos, API keys y la arquitectura canónica de checkout a webhook
framework-adapters	Route handlers `@dodopayments/*` oficiales para Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun y Convex
testing-and-go-live	Modo de prueba, métodos de pago de prueba, pruebas de webhooks y checklist de lanzamiento a producción

Aceptar pagos

Skill	Descripción
checkout-integration	Checkout Sessions, enlaces de pago y checkout superpuesto o inline
subscription-integration	Ciclo de vida de las suscripciones, pruebas gratuitas, cambios de plan, prorrateo y cargos bajo demanda
mobile-checkout	Checkout dentro de la aplicación para React Native, Flutter, iOS y Android
webhook-integration	Recepción y verificación de webhooks mediante la especificación Standard Webhooks

Modelos de facturación

Skill	Descripción
credit-based-billing	Derechos de crédito, saldos, libro mayor, rollover, exceso de uso y deducción basada en medidores
usage-based-billing	Medidores, ingesta de eventos, agregación y precios por unidad
license-keys	Activación y validación de license keys, y gestión de instancias

Catálogo y precios

Skill	Descripción
product-catalog-management	Productos, precios, complementos, colecciones, imágenes y entrega de productos digitales
discounts-and-promotions	Códigos de descuento, reglas de elegibilidad, acumulación y límites por ciclo de suscripción
localized-pricing	Precios localizados, moneda adaptativa y paridad de poder adquisitivo

Clientes y operaciones

Skill	Descripción
customer-management	Clientes, el portal de autoservicio, métodos de pago guardados y wallets
refunds-and-disputes	Emisión de reembolsos, gestión de disputas y contracargos, y conciliación del acceso

UI e integraciones

Skill	Descripción
billing-sdk	Componentes React de BillingSDK para tablas de precios y UI de facturación
better-auth-integration	El plugin `@dodopayments/better-auth` para sincronización de clientes, checkout y acceso al portal

Instalación

Elige tu método de instalación preferido según tu asistente de programación con IA.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Si usas Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro u OpenCode, el Dodo Agent Plugin instala las diecisiete skills y los dos servidores MCP en un solo paso. Las skills se cargan automáticamente cuando tu agente detecta una tarea relevante.Consulta la guía de AI Coding Agents para ver los comandos de instalación de cada agente.

Instala las skills mediante la CLI universal de skills, compatible con cualquier agente compatible con MCP:

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

También puedes instalar skills individuales según sea necesario:

# 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

Instala solo las skills que necesites para mantener tu agente centrado y reducir la sobrecarga de contexto.

Añade el marketplace de skills de Dodo Payments a Claude Code:

/plugin marketplace add dodopayments/skills

Después, instala plugins individuales:

# 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 carga las skills desde los directorios que le indiques. No analiza los paquetes instalados, por lo que se requiere una entrada explícita de skills.paths.Mediante el paquete 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"]
  }
}

Las rutas relativas se resuelven en relación con el directorio del proyecto, por lo que el paquete debe estar presente en su node_modules. También funciona una ruta absoluta y evita el requisito de instalación local.

Una ruta de skills que no existe se ignora silenciosamente: no se muestra ningún error ni advertencia. Confirma que las skills se hayan cargado correctamente:

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

Deberías ver las diecisiete.

Uso de las skills

Una vez instaladas, tu asistente de IA carga automáticamente la skill relevante cuando le pides que implemente una funcionalidad de Dodo Payments. No necesitas indicar el nombre de la skill; solo describe la tarea.

Ejemplo de prompt	Skill que se carga
Ayúdame a integrar Dodo Payments en mi aplicación de Next.js siguiendo las prácticas recomendadas	`dodo-best-practices`
Añade un route handler de checkout de Dodo Payments a mi aplicación de Hono	`framework-adapters`
Explícame cómo probar los pagos y pasar a producción	`testing-and-go-live`
Crea una sesión de checkout para mi producto SaaS	`checkout-integration`
Implementa un flujo de suscripción con una prueba gratuita y varios niveles de precios	`subscription-integration`
Añade un checkout dentro de la aplicación a mi aplicación de React Native	`mobile-checkout`
Configura handlers de webhook para eventos de pago y suscripción	`webhook-integration`
Configura derechos de crédito y deducción de créditos basada en medidores para mi producto de IA	`credit-based-billing`
Añade facturación basada en el uso para realizar un seguimiento de las llamadas a la API de mi producto de IA	`usage-based-billing`
Implementa la validación de license keys para mi aplicación de escritorio	`license-keys`
Crea un catálogo de productos con complementos y precios escalonados	`product-catalog-management`
Añade un código promocional con un 20 % de descuento en los tres primeros ciclos de facturación	`discounts-and-promotions`
Muestra los precios en la moneda local del visitante con paridad de poder adquisitivo	`localized-pricing`
Ofrece a los clientes un portal de autoservicio para gestionar sus métodos de pago	`customer-management`
Emite un reembolso parcial y revoca el acceso cuando se abre una disputa	`refunds-and-disputes`
Añade una página de precios usando componentes de BillingSDK	`billing-sdk`
Integra Dodo Payments en mi configuración de Better Auth	`better-auth-integration`

Cómo funcionan las skills

Las skills proporcionan a tu asistente de IA:

Conocimientos procedimentales - Instrucciones paso a paso para implementar funcionalidades
Plantillas de código - Patrones y fragmentos de código listos para producción
Prácticas recomendadas - Enfoques recomendados para la seguridad, la gestión de errores y la UX
Consciencia del contexto - Comprensión de cómo funcionan conjuntamente las distintas funcionalidades de Dodo Payments

Cuando pides a tu asistente de IA que implemente una funcionalidad, utiliza la skill relevante para:

Comprender el enfoque de implementación correcto
Generar código preciso y funcional
Seguir las convenciones de Dodo Payments
Gestionar correctamente los casos límite y los errores

Las skills complementan el MCP Server y Sentra. Usa MCP para las operaciones de API, Sentra para una integración guiada y las skills para mejorar las capacidades del asistente de IA.

Comparación con otras herramientas

Herramienta	Propósito	Ideal para
Agent Skills	Mejorar los conocimientos del asistente de IA	Desarrollo asistido por IA con cualquier cliente MCP
MCP Server	Ejecutar operaciones de API	Acceso directo a la API desde asistentes de IA
Sentra	Asistente de integración guiada	Integración interactiva de facturación en el IDE

Recursos

Skills Repository

Explora el código fuente y contribuye a las skills de Dodo Payments

MCP Server

Permite que los asistentes de IA ejecuten operaciones de la API de Dodo Payments

Sentra

Asistente de facturación con IA para tu IDE

Discord Community

Obtén ayuda y comparte tus comentarios con la comunidad

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Skills disponibles

Primeros pasos

Aceptar pagos

Modelos de facturación

Catálogo y precios

Clientes y operaciones

UI e integraciones

Instalación

Uso de las skills

Cómo funcionan las skills

Comparación con otras herramientas

Recursos

Skills Repository

MCP Server

Sentra

Discord Community

​Overview

​Skills disponibles

​Primeros pasos

​Aceptar pagos

​Modelos de facturación

​Catálogo y precios

​Clientes y operaciones

​UI e integraciones

​Instalación

​Uso de las skills

​Cómo funcionan las skills

​Comparación con otras herramientas

​Recursos

Skills Repository

MCP Server

Sentra

Discord Community

Overview

Skills disponibles

Primeros pasos

Aceptar pagos

Modelos de facturación

Catálogo y precios

Clientes y operaciones

UI e integraciones

Instalación

Uso de las skills

Cómo funcionan las skills

Comparación con otras herramientas

Recursos