Agent Skills

Overview

Le Agent Skills sono capacità riutilizzabili che migliorano ciò che gli assistenti AI per la programmazione possono fare quando lavorano con Dodo Payments. Forniscono conoscenze procedurali e best practice che aiutano gli agenti a completare attività specifiche in modo più efficace, dall’integrazione dei flussi di checkout alla configurazione del billing basato sull’utilizzo.

Considera le Skills come plugin per il tuo assistente AI. Insegnano al tuo agente come implementare correttamente le funzionalità di Dodo Payments, seguendo pattern e best practice consigliati.

Le Skills funzionano con qualsiasi agente AI che supporti il protocollo skills, tra cui:

Claude Code — l’assistente CLI per la programmazione di Anthropic
Codex CLI — l’agente CLI per la programmazione di OpenAI
Cursor — editor di codice AI-first
VS Code / GitHub Copilot — tramite l’Agent Plugin
Kiro — carica le Skills come Power
OpenCode — agente AI open source per la programmazione
Altri client — qualsiasi agente che supporti il protocollo skills

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

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

Il Dodo Agent Plugin installa tutti i diciassette Skills e i due server MCP in un unico passaggio per Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. 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 la CLI universale per le Skills, compatibile con qualsiasi agente che supporti le Skills:

# 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 focalizzato e ridurre l’overhead 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 nel relativo node_modules. Funziona anche un percorso assoluto, che evita il requisito dell’installazione locale.

Un percorso delle Skills inesistente viene ignorato silenziosamente: nessun errore e nessun avviso. Verifica che le Skills siano state effettivamente caricate:

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

Dovresti vederle 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 invece 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 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 subscription 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 gli webhook handler per gli eventi di pagamento e subscription	`webhook-integration`
Configura le credit entitlements e la deduzione dei crediti misurata per il mio prodotto AI	`credit-based-billing`
Aggiungi il billing basato sull’utilizzo per monitorare le chiamate API del mio prodotto AI	`usage-based-billing`
Implementa la convalida 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 promo code che offre il 20% di sconto per i primi tre cicli di billing	`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 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 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 funzionante e accurato, seguire le convenzioni di Dodo Payments e gestire correttamente casi limite ed errori.

Le Skills completano il MCP Server. Usa MCP per le operazioni API e le Skills per potenziare le capacità del tuo assistente AI.

Confronto con altri strumenti

Strumento	Scopo	Ideale per
Agent Skills	Migliorare le conoscenze dell’assistente AI	Sviluppo assistito dall’AI con qualsiasi agente che supporti le Skills
MCP Server	Eseguire operazioni API	Accesso diretto alle API dagli assistenti AI

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

Build with AI Coding Agents

Installa l’Agent Plugin: tutte le Skills e i due server MCP in un unico passaggio

Discord Community

Ottieni 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

Build with AI Coding Agents

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

Build with AI Coding Agents

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