Agent Skills

Overview

Les compétences d’agent sont des fonctionnalités réutilisables qui étendent les capacités des assistants de programmation IA lorsqu’ils travaillent avec Dodo Payments. Elles fournissent des connaissances procédurales et des bonnes pratiques qui aident les agents à accomplir plus efficacement des tâches spécifiques, de l’intégration des parcours de checkout à la configuration de la facturation basée sur l’utilisation.

Considérez les compétences comme des plugins pour votre assistant IA. Elles enseignent à votre agent comment implémenter correctement les fonctionnalités de Dodo Payments, en suivant les modèles recommandés et les bonnes pratiques.

Les compétences fonctionnent avec tout agent IA prenant en charge le protocole des compétences, notamment :

Claude Code — assistant de programmation CLI d’Anthropic
Codex CLI — agent de programmation CLI d’OpenAI
Cursor — éditeur de code axé sur l’IA
VS Code / GitHub Copilot — via le plugin d’agent
Kiro — charge les compétences en tant que Power
OpenCode — agent de programmation IA open source
Autres clients — tout agent prenant en charge le protocole des compétences

Gemini CLI est l’exception. Il ne dispose pas de primitive de compétence d’agent, les compétences 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

Le plugin d’agent Dodo installe en une seule étape les dix-sept compétences ainsi que les deux serveurs MCP pour Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro et OpenCode. Les compétences 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 compétences à l’aide de la CLI universelle de compétences, compatible avec tout agent prenant en charge les compétences :

# 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 compétences dont vous avez besoin afin de garder votre agent concentré et de réduire la surcharge de contexte.

Ajoutez la marketplace de compétences Dodo Payments à Claude Code :

/plugin marketplace add dodopayments/skills

Installez ensuite les plugins individuellement :

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

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 node_modules de ce projet. Un chemin absolu fonctionne également et évite l’obligation d’une installation locale.

Un chemin de compétences qui n’existe pas est ignoré silencieusement — aucune erreur ni aucun avertissement. Vérifiez que les compétences sont bien chargées :

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

Vous devriez toutes les voir, au nombre de dix-sept.

Utiliser les compétences

Une fois installées, vos assistants de programmation IA chargent automatiquement la compétence pertinente lorsque vous leur demandez d’implémenter une fonctionnalité de Dodo Payments. Vous n’avez pas besoin de nommer la compétence ; décrivez plutôt la tâche.

Exemple de prompt	Compétence chargée
Aidez-moi à intégrer Dodo Payments dans mon application Next.js en suivant les bonnes pratiques	`dodo-best-practices`
Ajoutez un gestionnaire de route checkout Dodo Payments à mon application Hono	`framework-adapters`
Guidez-moi pour tester les paiements et passer en production	`testing-and-go-live`
Créez une session de checkout pour mon produit SaaS	`checkout-integration`
Implémentez un parcours d’abonnement avec une période d’essai gratuite et plusieurs niveaux tarifaires	`subscription-integration`
Ajoutez un checkout intégré à mon application React Native	`mobile-checkout`
Configurez des gestionnaires de webhook pour les événements de paiement et d’abonnement	`webhook-integration`
Configurez les droits aux crédits et la déduction des crédits mesurés 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 modules complémentaires 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 tarifaire à l’aide des composants BillingSDK	`billing-sdk`
Intégrez Dodo Payments à ma configuration Better Auth	`better-auth-integration`

Fonctionnement des compétences

Les compétences fournissent à votre assistant IA :

Connaissances procédurales — Instructions étape par étape pour implémenter des fonctionnalités
Modèles de code — Modèles et extraits de code prêts pour la production
Bonnes pratiques — Approches recommandées en matière de sécurité, de gestion des erreurs et d’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 la compétence pertinente pour comprendre la bonne approche d’implémentation, générer un code fonctionnel et précis, suivre les conventions de Dodo Payments et gérer correctement les cas limites ainsi que les erreurs.

Les compétences complètent le MCP Server. Utilisez MCP pour les opérations API et les compétences pour améliorer les capacités de votre assistant IA.

Comparaison avec d’autres outils

Outil	Fonction	Idéal pour
Compétences d’agent	Enrichir les connaissances de l’assistant IA	Développement assisté par IA avec tout agent prenant en charge les compétences
MCP Server	Exécuter des opérations API	Accès direct à l’API depuis des assistants IA

Ressources

Skills Repository

Parcourez le code source et contribuez aux compétences Dodo Payments

MCP Server

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

Build with AI Coding Agents

Installez le plugin d’agent : toutes les compétences ainsi que les deux serveurs MCP en une seule étape

Discord Community

Obtenez de l’aide et partagez 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 compétences

Fonctionnement des compétences

Comparaison avec d’autres outils

Ressources

Skills Repository

MCP Server

Build with AI Coding Agents

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 compétences

​Fonctionnement des compétences

​Comparaison avec d’autres outils

​Ressources

Skills Repository

MCP Server

Build with AI Coding Agents

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 compétences

Fonctionnement des compétences

Comparaison avec d’autres outils

Ressources