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.

Les skills fonctionnent avec tout agent IA prenant en charge le protocole skills, notamment :

Claude Code - assistant de programmation CLI d’Anthropic
Codex CLI - agent de programmation CLI d’OpenAI
Cursor - éditeur de code conçu autour de l’IA
VS Code / GitHub Copilot - via le plugin Agent
Kiro - charge les skills en tant que Power
OpenCode - agent de programmation IA open source
Autres clients - tout agent prenant en charge le protocole skills

Gemini CLI est l’exception. Il ne dispose d’aucun primitive agent-skill, les skills n’y sont donc pas disponibles — seuls les deux serveurs MCP le sont.

Skills disponibles

Dix-sept skills couvrant l’ensemble de la surface d’intégration, regroupés selon la tâche sur laquelle vous travaillez.

Premiers pas

Skill	Description
dodo-best-practices	Configuration du SDK, environnements, clés API et architecture canonique checkout-to-webhook
framework-adapters	Gestionnaires de routes `@dodopayments/*` officiels pour Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun et Convex
testing-and-go-live	Mode test, moyens de paiement de test, tests des webhooks et checklist de mise en production

Accepter les paiements

Skill	Description
checkout-integration	Checkout Sessions, liens de paiement et checkout superposé ou inline
subscription-integration	Cycle de vie des abonnements, essais, changements de plan, proratisation et frais à la demande
mobile-checkout	Checkout intégré à l’application pour React Native, Flutter, iOS et Android
webhook-integration	Réception et vérification des webhooks à l’aide de la spécification Standard Webhooks

Modèles de facturation

Skill	Description
credit-based-billing	Droits de crédit, soldes, registre, report, dépassement et déduction basée sur un meter
usage-based-billing	Meters, ingestion d’événements, agrégation et tarification à l’unité
license-keys	Activation et validation des clés de licence, ainsi que gestion des instances

Catalogue et tarification

Skill	Description
product-catalog-management	Produits, tarification, add-ons, collections, images et distribution de produits numériques
discounts-and-promotions	Codes de réduction, règles d’éligibilité, cumul et limites liées aux cycles d’abonnement
localized-pricing	Tarification localisée, adaptive currency et parité de pouvoir d’achat

Clients et opérations

Skill	Description
customer-management	Clients, portail en libre-service, moyens de paiement enregistrés et wallets
refunds-and-disputes	Émission de remboursements, gestion des litiges et des rétrofacturations, et réconciliation des accès

Interface utilisateur et intégrations

Skill	Description
billing-sdk	Composants React BillingSDK pour les tableaux de tarification et l’interface de facturation
better-auth-integration	Plugin `@dodopayments/better-auth` pour la synchronisation des clients, le checkout et l’accès au portail

Installation

Choisissez votre méthode d’installation préférée en fonction de votre assistant de programmation IA.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Si vous utilisez Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro ou OpenCode, le plugin Agent Dodo installe les dix-sept skills ainsi que les deux serveurs MCP en une seule étape. Les skills se chargent automatiquement lorsque votre agent détecte une tâche pertinente.Consultez le guide des agents de programmation IA pour connaître les commandes d’installation propres à chaque agent.

Installez les skills à l’aide de la skills CLI universelle, compatible avec tout agent compatible MCP :

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

Vous pouvez également installer des skills individuels selon vos besoins :

# 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

Installez uniquement les skills dont vous avez besoin afin de garder votre agent concentré et de réduire la surcharge de contexte.

Ajoutez la marketplace de skills Dodo Payments à Claude Code :

/plugin marketplace add dodopayments/skills

Installez ensuite les plugins individuels :

# 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 charge les skills depuis les répertoires que vous lui indiquez. Il n’analyse pas les packages installés ; une entrée explicite skills.paths est donc requise.Utilisation du package 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"]
  }
}

Les chemins relatifs sont résolus par rapport au répertoire du projet ; le package doit donc être présent dans le node_modules de ce projet. Un chemin absolu fonctionne également et évite d’avoir à effectuer une installation locale.

Un chemin de skills qui n’existe pas est ignoré silencieusement — aucune erreur ni aucun avertissement. Vérifiez que les skills ont bien été chargés :

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

Vous devriez tous les voir apparaître, au nombre de dix-sept.

Utiliser les skills

Une fois installés, vos assistant IA charge automatiquement le skill pertinent lorsque vous lui demandez d’implémenter une fonctionnalité Dodo Payments. Vous n’avez pas besoin de nommer le skill : décrivez simplement la tâche.

Exemple de prompt	Skill chargé
Aidez-moi à intégrer Dodo Payments dans mon application Next.js en suivant les bonnes pratiques	`dodo-best-practices`
Ajoutez un gestionnaire de routes checkout Dodo Payments à mon application Hono	`framework-adapters`
Guidez-moi dans les tests des paiements et la mise en production	`testing-and-go-live`
Créez une session checkout pour mon produit SaaS	`checkout-integration`
Implémentez un parcours d’abonnement avec un essai gratuit et plusieurs niveaux de tarification	`subscription-integration`
Ajoutez un checkout intégré à l’application React Native	`mobile-checkout`
Configurez des gestionnaires de webhooks pour les événements de paiement et d’abonnement	`webhook-integration`
Configurez les droits de crédit et la déduction de crédits basée sur un meter pour mon produit IA	`credit-based-billing`
Ajoutez une facturation basée sur l’utilisation pour suivre les appels API de mon produit IA	`usage-based-billing`
Implémentez la validation des clés de licence pour mon application de bureau	`license-keys`
Créez un catalogue de produits avec des add-ons et une tarification par niveaux	`product-catalog-management`
Ajoutez un code promotionnel offrant 20 % de réduction sur les trois premiers cycles de facturation	`discounts-and-promotions`
Affichez les prix dans la devise locale du visiteur avec la parité de pouvoir d’achat	`localized-pricing`
Donnez aux clients un portail en libre-service pour gérer leurs moyens de paiement	`customer-management`
Émettez un remboursement partiel et révoquez l’accès lorsqu’un litige est ouvert	`refunds-and-disputes`
Ajoutez une page de tarification à l’aide des composants BillingSDK	`billing-sdk`
Intégrez Dodo Payments à ma configuration Better Auth	`better-auth-integration`

Fonctionnement des skills

Les skills fournissent à votre assistant IA :

Connaissances procédurales - Instructions étape par étape pour implémenter des fonctionnalités
Modèles de code - Patterns et snippets de code prêts pour la production
Bonnes pratiques - Approches recommandées pour la sécurité, la gestion des erreurs et l’UX
Compréhension du contexte - Compréhension de la manière dont les différentes fonctionnalités de Dodo Payments fonctionnent ensemble

Lorsque vous demandez à votre assistant IA d’implémenter une fonctionnalité, il utilise le skill pertinent pour :

Comprendre la bonne approche d’implémentation
Générer un code précis et fonctionnel
Respecter les conventions de Dodo Payments
Gérer correctement les cas particuliers et les erreurs

Les skills complètent le serveur MCP et Sentra. Utilisez MCP pour les opérations API, Sentra pour une intégration guidée et les skills pour améliorer les capacités de votre assistant IA.

Comparaison avec d’autres outils

Outil	Objectif	Idéal pour
Agent Skills	Enrichir les connaissances de l’assistant IA	Développement assisté par IA avec tout client MCP
Serveur MCP	Exécuter des opérations API	Accès direct à l’API depuis les assistants IA
Sentra	Assistant d’intégration guidée	Intégration interactive de la facturation dans l’IDE

Ressources

Skills Repository

Parcourir le code source et contribuer aux skills Dodo Payments

MCP Server

Permettre aux assistants IA d’exécuter des opérations API Dodo Payments

Sentra

Assistant de facturation optimisé par l’IA pour votre IDE

Discord Community

Obtenir de l’aide et partager vos retours avec la communauté

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Skills disponibles

Premiers pas

Accepter les paiements

Modèles de facturation

Catalogue et tarification

Clients et opérations

Interface utilisateur et intégrations

Installation

Utiliser les skills

Fonctionnement des skills

Comparaison avec d’autres outils

Ressources

Skills Repository

MCP Server

Sentra

Discord Community

​Overview

​Skills disponibles

​Premiers pas

​Accepter les paiements

​Modèles de facturation

​Catalogue et tarification

​Clients et opérations

​Interface utilisateur et intégrations

​Installation

​Utiliser les skills

​Fonctionnement des skills

​Comparaison avec d’autres outils

​Ressources

Skills Repository

MCP Server

Sentra

Discord Community

Overview

Skills disponibles

Premiers pas

Accepter les paiements

Modèles de facturation

Catalogue et tarification

Clients et opérations

Interface utilisateur et intégrations

Installation

Utiliser les skills

Fonctionnement des skills

Comparaison avec d’autres outils

Ressources