Agent Skills

Overview

Las Agent Skills son capacidades reutilizables que amplían lo que los asistentes de programación con IA pueden hacer al trabajar con Dodo Payments. Proporcionan conocimientos procedimentales y prácticas recomendadas que ayudan a los agentes a realizar tareas específicas de forma más eficaz, desde integrar flujos de checkout hasta configurar la facturación basada en el uso.

Piensa en las skills como plugins para tu asistente de IA. Enseñan a tu agente a implementar correctamente las funciones de Dodo Payments siguiendo patrones recomendados y prácticas recomendadas.

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 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 un primitivo de agent-skill, por lo que las skills no están disponibles allí; solo están disponibles 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

El Dodo Agent Plugin instala las diecisiete skills y los dos servidores MCP en un solo paso para Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro y OpenCode. 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, que funciona con cualquier agente compatible con skills:

# 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 necesitas para mantener tu agente enfocado y reducir la sobrecarga de contexto.

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

/plugin marketplace add dodopayments/skills

A continuación, 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 examina los paquetes instalados, por lo que se requiere una entrada explícita de skills.paths.Uso del 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 con respecto al directorio del proyecto, por lo que el paquete debe estar presente en el node_modules de ese proyecto. También funciona una ruta absoluta y evita el requisito de instalación local.

Una ruta de skills que no existe se ignora silenciosamente: sin errores ni advertencias. 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 función de Dodo Payments. No necesitas indicar el nombre de la skill; describe la tarea en su lugar.

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`
Guíame para probar los pagos y pasar a producción	`testing-and-go-live`
Crea una checkout session 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 checkout dentro de la aplicación a mi aplicación de React Native	`mobile-checkout`
Configura handlers de webhook para eventos de pagos y suscripciones	`webhook-integration`
Configura entitlements de crédito y la deducción de créditos medidos 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 claves de licencia 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 que aplique un 20 % de descuento durante 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 lo siguiente:

Conocimientos procedimentales — Instrucciones paso a paso para implementar funciones
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
Conciencia del contexto — Comprensión de cómo funcionan conjuntamente las distintas funciones de Dodo Payments

Cuando pides a tu asistente de IA que implemente una función, utiliza la skill relevante para comprender el enfoque correcto de implementación, generar código preciso y funcional, seguir las convenciones de Dodo Payments y gestionar correctamente los casos extremos y los errores.

Las skills complementan el MCP Server. Usa MCP para las operaciones de API y las skills para mejorar las capacidades de tu 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 agente compatible con skills
MCP Server	Ejecutar operaciones de API	Acceso directo a la API desde asistentes de IA

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

Build with AI Coding Agents

Instala el Agent Plugin: todas las skills y los dos servidores MCP en un solo paso

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

Build with AI Coding Agents

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

Build with AI Coding Agents

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