> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Enhance your AI coding assistants with official Dodo Payments skills for seamless payment integrations, webhook handling, and billing flows.

## 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.

<Info>
  **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.
</Info>

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

| Skill                                                                                                               | Description                                                              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [dodo-best-practices](https://github.com/dodopayments/skills/tree/main/dodo-payments/best-practices)                | Comprehensive guide to integrating Dodo Payments with best practices     |
| [webhook-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/webhook-integration)           | Setting up and handling webhooks for payment events                      |
| [subscription-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/subscription-integration) | Implementing subscription billing flows                                  |
| [checkout-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/checkout-integration)         | Creating checkout sessions and payment flows                             |
| [usage-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/usage-based-billing)           | Implementing metered billing with events and meters                      |
| [billing-sdk](https://github.com/dodopayments/skills/tree/main/dodo-payments/billing-sdk)                           | Using BillingSDK React components                                        |
| [license-keys](https://github.com/dodopayments/skills/tree/main/dodo-payments/license-keys)                         | Managing license keys for digital products                               |
| [credit-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/credit-based-billing)         | Implementing credit entitlements, balances, and metered credit deduction |

## Installation

Choose your preferred installation method based on your AI coding assistant.

<Tabs>
  <Tab title="Agent Plugin (recommended)">
    Se stai usando Claude Code, Codex CLI, Cursor o OpenCode, il [Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) installa tutte e otto le competenze più entrambi i server MCP in un solo passaggio. Le competenze si caricano automaticamente quando il tuo agente rileva un compito pertinente.

    Consulta la [guida agli AI Coding Agents](/developer-resources/build-with-ai-coding-agents) per i comandi di installazione per agente.
  </Tab>

  <Tab title="Skills CLI">
    Installa le competenze utilizzando la CLI universale delle competenze che funziona con qualsiasi agente compatibile con MCP:

    ```bash theme={null}
    # Install all Dodo Payments skills
    npx skills add dodopayments/skills
    ```

    Oppure installa singole competenze secondo necessità:

    ```bash theme={null}
    # Best practices guide
    npx skills add dodopayments/skills/dodo-payments/best-practices

    # Webhook integration
    npx skills add dodopayments/skills/dodo-payments/webhook-integration

    # Subscription billing
    npx skills add dodopayments/skills/dodo-payments/subscription-integration

    # Checkout flows
    npx skills add dodopayments/skills/dodo-payments/checkout-integration

    # Usage-based billing
    npx skills add dodopayments/skills/dodo-payments/usage-based-billing

    # BillingSDK components
    npx skills add dodopayments/skills/dodo-payments/billing-sdk

    # License key management
    npx skills add dodopayments/skills/dodo-payments/license-keys

    # Credit-based billing
    npx skills add dodopayments/skills/dodo-payments/credit-based-billing
    ```

    <Tip>
      Installa solo le competenze necessarie per mantenere il tuo agente focalizzato e ridurre il sovraccarico di contesto.
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    Aggiungi il marketplace delle competenze Dodo Payments a Claude Code:

    ```bash theme={null}
    /plugin marketplace add dodopayments/skills
    ```

    Quindi installa plugin individuali:

    ```bash theme={null}
    # Install best practices
    /plugin install dodo-best-practices

    # Install webhook integration
    /plugin install webhook-integration

    # Install subscription integration
    /plugin install subscription-integration

    # Install checkout integration
    /plugin install checkout-integration

    # Install usage-based billing
    /plugin install usage-based-billing

    # Install BillingSDK
    /plugin install billing-sdk

    # Install license keys
    /plugin install license-keys

    # Install credit-based billing
    /plugin install credit-based-billing
    ```
  </Tab>

  <Tab title="OpenCode">
    Le competenze sono automaticamente disponibili quando configurate nelle tue impostazioni OpenCode. Aggiungi il repository delle competenze Dodo Payments alla tua configurazione:

    ```json theme={null}
    {
      "skills": {
        "repositories": [
          "dodopayments/skills"
        ]
      }
    }
    ```
  </Tab>
</Tabs>

## Utilizzo delle Competenze

Una volta installate, il tuo assistente AI può sfruttare queste competenze quando gli chiedi di implementare funzionalità di Dodo Payments. Ecco alcuni esempi di prompt:

### Migliori Pratiche

```
Help me integrate Dodo Payments into my Next.js app following best practices
```

### Webhook

```
Set up webhook handlers for payment and subscription events
```

### Abbonamenti

```
Implement a subscription flow with free trial and multiple pricing tiers
```

### Checkout

```
Create a checkout session for my SaaS product
```

### Fatturazione Basata sul Consumo

```
Add usage-based billing to track API calls for my AI product
```

### BillingSDK

```
Add a pricing page using BillingSDK components
```

### Chiavi di Licenza

```
Implement license key validation for my desktop app
```

### Fatturazione Basata su Credito

```
Set up credit entitlements and metered credit deduction for my AI product
```

## Come Funzionano le Competenze

Le competenze offrono al tuo assistente AI:

1. **Conoscenza Procedurale** - Istruzioni passo a passo per l'implementazione delle funzionalità
2. **Template di Codice** - Modelli di codice pronti per la produzione e frammenti
3. **Migliori Pratiche** - Approcci consigliati per sicurezza, gestione degli errori e UX
4. **Consapevolezza del Contesto** - Comprensione di come funzionano insieme le diverse funzionalità di Dodo Payments

Quando chiedi al tuo assistente AI di implementare una funzionalità, utilizza la competenza pertinente per:

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

<Note>
  Le competenze completano il [MCP Server](/developer-resources/mcp-server) e [Sentra](/developer-resources/sentra). Usa MCP per operazioni API, Sentra per un'integrazione guidata e le Competizioni per migliorare le capacità del tuo assistente AI.
</Note>

## Confronto con Altri Strumenti

| Strumento             | Scopo                                       | Ideale Per                                        |
| --------------------- | ------------------------------------------- | ------------------------------------------------- |
| **Competenze Agente** | Migliorare la conoscenza dell'assistente AI | Sviluppo assistito da AI con qualsiasi client MCP |
| **MCP Server**        | Eseguire operazioni API                     | Accesso diretto API dagli assistenti AI           |
| **Sentra**            | Assistente di integrazione guidata          | Integrazione di fatturazione interattiva nell'IDE |

## Risorse

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/dodopayments/skills">
    Esplora il codice sorgente e contribuisci alle competenze Dodo Payments
  </Card>

  <Card title="MCP Server" icon="server" href="/developer-resources/mcp-server">
    Abilita gli assistenti AI a eseguire operazioni API di Dodo Payments
  </Card>

  <Card title="Sentra" icon="wand-magic-sparkles" href="/developer-resources/sentra">
    Assistente di fatturazione potenziato da AI per il tuo IDE
  </Card>

  <Card title="Discord Community" icon="discord" href="https://discord.gg/bYqAp4ayYh">
    Ottieni assistenza e condividi feedback con la comunità
  </Card>
</CardGroup>