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.

Skills work with any MCP-compatible AI agent, including:

Claude Code - Anthropic’s CLI coding assistant
OpenCode - Open source AI coding agent
Cursor - AI-first code editor
Other MCP clients - Any agent supporting the skills protocol

Available Skills

Diciassette skill che coprono l’intera superficie di integrazione, raggruppate in base all’attività su cui stai lavorando.

Per iniziare

Skill	Descrizione
dodo-best-practices	Configurazione dell’SDK, ambienti, API keys e architettura canonica da checkout a webhook
framework-adapters	Route handler ufficiali `@dodopayments/*` per Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun e Convex
testing-and-go-live	Modalità test, metodi di pagamento di test, test dei webhook e checklist per il lancio in produzione

Accettare pagamenti

Skill	Descrizione
checkout-integration	Checkout Sessions, link di pagamento e checkout overlay o inline
subscription-integration	Ciclo di vita degli abbonamenti, periodi di prova, modifiche dei piani, prorata e addebiti on-demand
mobile-checkout	Checkout in-app per React Native, Flutter, iOS e Android
webhook-integration	Ricezione e verifica dei webhook usando la specifica Standard Webhooks

Modelli di fatturazione

Skill	Descrizione
credit-based-billing	Entitlement di crediti, saldi, ledger, rollover, eccedenze e detrazione basata su meter
usage-based-billing	Meter, acquisizione degli eventi, aggregazione e prezzi per unità
license-keys	Attivazione e convalida delle chiavi di licenza e gestione delle istanze

Catalogo e prezzi

Skill	Descrizione
product-catalog-management	Prodotti, prezzi, componenti aggiuntivi, raccolte, immagini e distribuzione di prodotti digitali
discounts-and-promotions	Codici sconto, regole di idoneità, cumulabilità e limiti per ciclo di abbonamento
localized-pricing	Prezzi localizzati, Adaptive Currency e parità del potere d’acquisto

Clienti e operazioni

Skill	Descrizione
customer-management	Clienti, portale self-service, metodi di pagamento salvati e wallet
refunds-and-disputes	Emissione di rimborsi, gestione di contestazioni e chargeback e riconciliazione degli accessi

UI e integrazioni

Skill	Descrizione
billing-sdk	Componenti React di BillingSDK per tabelle dei prezzi e UI di fatturazione
better-auth-integration	Plugin `@dodopayments/better-auth` per la sincronizzazione dei clienti, il checkout e l’accesso al portale

Installazione

Scegli il metodo di installazione che preferisci in base al tuo assistente di programmazione AI.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Se utilizzi Claude Code, Codex CLI, Cursor o OpenCode, il Dodo Agent Plugin installa tutti e diciassette gli skill e entrambi i server MCP in un unico passaggio. Gli skill vengono caricati automaticamente quando il tuo agent rileva un’attività pertinente.Consulta la guida agli AI Coding Agents per i comandi di installazione specifici per ogni agent.

Installa gli skill usando il skills CLI universale, compatibile con qualsiasi agent compatibile con MCP:

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

Oppure installa singoli skill secondo necessità:

# Getting started
npx skills add dodopayments/skills/dodo-payments/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

Installa solo gli skill di cui hai bisogno per mantenere concentrato il tuo agent e ridurre il sovraccarico di contesto.

Aggiungi il marketplace degli skill di Dodo Payments a Claude Code:

/plugin marketplace add dodopayments/skills

Quindi installa i singoli plugin:

# 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

Gli skill sono automaticamente disponibili quando vengono configurati nelle impostazioni di OpenCode. Aggiungi il repository degli skill di Dodo Payments alla configurazione:

{
  "skills": {
    "repositories": [
      "dodopayments/skills"
    ]
  }
}

Utilizzare gli skill

Una volta installati, il tuo assistente di programmazione AI carica automaticamente lo skill pertinente quando gli chiedi di implementare una funzionalità di Dodo Payments. Non è necessario indicare il nome dello skill: descrivi semplicemente l’attività.

Prompt di esempio	Skill caricato
Aiutami a integrare Dodo Payments nella mia app Next.js seguendo le best practice	`dodo-best-practices`
Aggiungi un route handler di checkout di Dodo Payments alla mia app Hono	`framework-adapters`
Guidami nei test dei pagamenti e nella messa in produzione	`testing-and-go-live`
Crea una checkout session per il mio prodotto SaaS	`checkout-integration`
Implementa un flusso di abbonamento con un periodo di prova gratuito e più livelli di prezzo	`subscription-integration`
Aggiungi il checkout in-app alla mia app React Native	`mobile-checkout`
Configura i webhook handler per gli eventi di pagamento e abbonamento	`webhook-integration`
Configura gli entitlement di crediti e la detrazione dei crediti misurata per il mio prodotto AI	`credit-based-billing`
Aggiungi la fatturazione basata sull’utilizzo per monitorare le chiamate API del mio prodotto AI	`usage-based-billing`
Implementa la convalida delle chiavi di licenza per la mia app desktop	`license-keys`
Crea un catalogo prodotti con componenti aggiuntivi e prezzi a livelli	`product-catalog-management`
Aggiungi un codice promozionale con uno sconto del 20% sui primi tre cicli di fatturazione	`discounts-and-promotions`
Mostra i prezzi nella valuta locale del visitatore con la parità del potere d’acquisto	`localized-pricing`
Fornisci ai clienti un portale self-service per gestire i metodi di pagamento	`customer-management`
Emetti un rimborso parziale e revoca l’accesso quando viene aperta una contestazione	`refunds-and-disputes`
Aggiungi una pagina dei prezzi usando i componenti BillingSDK	`billing-sdk`
Integra Dodo Payments nella mia configurazione Better Auth	`better-auth-integration`

Come funzionano gli skill

Gli skill forniscono al tuo assistente di programmazione AI:

Conoscenze procedurali - Istruzioni dettagliate per implementare le funzionalità
Template di codice - Pattern e snippet di codice pronti per la produzione
Best practice - Approcci consigliati per sicurezza, gestione degli errori e UX
Consapevolezza del contesto - Comprensione di come le diverse funzionalità di Dodo Payments collaborano tra loro

Quando chiedi al tuo assistente di programmazione AI di implementare una funzionalità, utilizza lo skill pertinente per:

Comprendere l’approccio corretto all’implementazione
Generare codice accurato e funzionante
Seguire le convenzioni di Dodo Payments
Gestire correttamente casi limite ed errori

Gli skill completano il MCP Server e Sentra. Usa MCP per le operazioni API, Sentra per l’integrazione guidata e gli skill per potenziare le capacità dell’assistente di programmazione AI.

Confronto con altri strumenti

Strumento	Scopo	Ideale per
Agent Skills	Ampliare le conoscenze dell’assistente di programmazione AI	Sviluppo assistito dall’AI con qualsiasi client MCP
MCP Server	Eseguire operazioni API	Accesso diretto alle API dagli assistenti di programmazione AI
Sentra	Assistente per l’integrazione guidata	Integrazione interattiva della fatturazione nell’IDE

Risorse

Skills Repository

Esamina il codice sorgente e contribuisci agli skill di Dodo Payments

MCP Server

Consenti agli assistenti di programmazione AI di eseguire operazioni API di Dodo Payments

Sentra

Assistente di fatturazione basato sull’AI per il tuo IDE

Discord Community

Ottieni assistenza e condividi feedback con la community

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Available Skills

Per iniziare

Accettare pagamenti

Modelli di fatturazione

Catalogo e prezzi

Clienti e operazioni

UI e integrazioni

Installazione

Utilizzare gli skill

Come funzionano gli skill

Confronto con altri strumenti

Risorse

Skills Repository

MCP Server

Sentra

Discord Community

​Overview

​Available Skills

​Per iniziare

​Accettare pagamenti

​Modelli di fatturazione

​Catalogo e prezzi

​Clienti e operazioni

​UI e integrazioni

​Installazione

​Utilizzare gli skill

​Come funzionano gli skill

​Confronto con altri strumenti

​Risorse

Skills Repository

MCP Server

Sentra

Discord Community

Overview

Available Skills

Per iniziare

Accettare pagamenti

Modelli di fatturazione

Catalogo e prezzi

Clienti e operazioni

UI e integrazioni

Installazione

Utilizzare gli skill

Come funzionano gli skill

Confronto con altri strumenti

Risorse