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 funzionano con qualsiasi agente AI che supporti il skills protocol, tra cui:

Claude Code - assistente di programmazione CLI di Anthropic
Codex CLI - agente di programmazione CLI di OpenAI
Cursor - editor di codice basato innanzitutto sull’AI
VS Code / GitHub Copilot - tramite il Agent Plugin
Kiro - carica le skills come Power
OpenCode - agente di programmazione AI open source
Altri client - qualsiasi agente che supporti il skills protocol

Gemini CLI è l’eccezione. Non dispone di una primitiva agent-skill, quindi le skills non sono disponibili; sono disponibili solo i due MCP servers.

Skills disponibili

Diciassette skills 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, chiavi API e architettura canonica checkout-to-webhook
framework-adapters	Gestori di route `@dodopayments/*` ufficiali 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 ai piani, prorating e addebiti on-demand
mobile-checkout	Checkout in-app per React Native, Flutter, iOS e Android
webhook-integration	Ricezione e verifica dei webhook secondo la specifica Standard Webhooks

Modelli di fatturazione

Skill	Descrizione
credit-based-billing	Entitlement dei crediti, saldi, ledger, rollover, overage e deduzione basata su meter
usage-based-billing	Meter, acquisizione degli eventi, aggregazione e prezzi per unità
license-keys	Attivazione e validazione delle license key e gestione delle istanze

Catalogo e prezzi

Skill	Descrizione
product-catalog-management	Prodotti, prezzi, add-on, raccolte, immagini e distribuzione di prodotti digitali
discounts-and-promotions	Codici sconto, regole di idoneità, combinazione degli sconti 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	Il 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, VS Code / GitHub Copilot, Kiro o OpenCode, il Dodo Agent Plugin installa tutte le diciassette skills e i due MCP servers in un unico passaggio. Le skills vengono caricate automaticamente quando il tuo agente rileva un’attività pertinente.Consulta la guida agli AI Coding Agents per i comandi di installazione specifici per ogni agente.

Installa le skills utilizzando il skills CLI universale, compatibile con qualsiasi agente compatibile con MCP:

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

Oppure installa singole skills secondo necessità:

# 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

Installa solo le skills necessarie per mantenere il tuo agente concentrato e ridurre il sovraccarico di contesto.

Aggiungi il marketplace delle skills 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

OpenCode carica le skills dalle directory che gli indichi. Non esegue la scansione dei pacchetti installati, quindi è necessaria una voce skills.paths esplicita.Utilizzando il pacchetto 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"]
  }
}

I percorsi relativi vengono risolti rispetto alla directory del progetto, quindi il pacchetto deve essere presente nella node_modules di quel progetto. Funziona anche un percorso assoluto, che evita il requisito dell’installazione locale.

Un percorso delle skills che non esiste viene ignorato silenziosamente: nessun errore e nessun avviso. Conferma che le skills siano state effettivamente caricate:

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

Dovresti visualizzarle tutte e diciassette.

Utilizzo delle skills

Una volta installate, il tuo assistente AI carica automaticamente la skill pertinente quando gli chiedi di implementare una funzionalità di Dodo Payments. Non è necessario specificare il nome della skill: descrivi semplicemente l’attività.

Prompt di esempio	Skill caricata
Aiutami a integrare Dodo Payments nella mia app Next.js seguendo le best practice	`dodo-best-practices`
Aggiungi un gestore di route 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 gestori webhook per gli eventi di pagamento e abbonamento	`webhook-integration`
Configura gli entitlement dei crediti e la deduzione dei crediti basata su meter 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 validazione delle license key per la mia app desktop	`license-keys`
Crea un catalogo prodotti con add-on e prezzi a livelli	`product-catalog-management`
Aggiungi un codice promozionale che offre il 20% di sconto 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 loro 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 utilizzando i componenti BillingSDK	`billing-sdk`
Integra Dodo Payments nella mia configurazione Better Auth	`better-auth-integration`

Come funzionano le skills

Le skills forniscono al tuo assistente AI:

Conoscenze procedurali - Istruzioni passo passo 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 interagiscono tra loro

Quando chiedi al tuo assistente AI di implementare una funzionalità, utilizza la 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

Le skills completano il MCP Server e Sentra. Usa MCP per le operazioni API, Sentra per l’integrazione guidata e le skills per potenziare le funzionalità dell’assistente AI.

Confronto con altri strumenti

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

Risorse

Skills Repository

Esplora il codice sorgente e contribuisci alle skills di Dodo Payments

MCP Server

Consenti agli assistenti AI di eseguire operazioni API di Dodo Payments

Sentra

Assistente per la fatturazione basato sull’AI per il tuo IDE

Discord Community

Ricevi assistenza e condividi feedback con la community

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Skills disponibili

Per iniziare

Accettare pagamenti

Modelli di fatturazione

Catalogo e prezzi

Clienti e operazioni

UI e integrazioni

Installazione

Utilizzo delle skills

Come funzionano le skills

Confronto con altri strumenti

Risorse

Skills Repository

MCP Server

Sentra

Discord Community

​Overview

​Skills disponibili

​Per iniziare

​Accettare pagamenti

​Modelli di fatturazione

​Catalogo e prezzi

​Clienti e operazioni

​UI e integrazioni

​Installazione

​Utilizzo delle skills

​Come funzionano le skills

​Confronto con altri strumenti

​Risorse

Skills Repository

MCP Server

Sentra

Discord Community

Overview

Skills disponibili

Per iniziare

Accettare pagamenti

Modelli di fatturazione

Catalogo e prezzi

Clienti e operazioni

UI e integrazioni

Installazione

Utilizzo delle skills

Come funzionano le skills

Confronto con altri strumenti

Risorse