> ## 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 você estiver usando Claude Code, Codex CLI, Cursor, ou OpenCode, o [Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) instala todas as oito skills mais ambos os servidores MCP em uma única etapa. As skills são carregadas automaticamente quando seu agente detecta uma tarefa relevante.

    Veja o [guia de Agentes de Codificação de IA](/developer-resources/build-with-ai-coding-agents) para comandos de instalação por agente.
  </Tab>

  <Tab title="Skills CLI">
    Instale skills usando o CLI de skills universal que funciona com qualquer agente compatível com MCP:

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

    Ou instale skills individuais conforme necessário:

    ```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>
      Instale apenas as skills que você precisa para manter seu agente focado e reduzir a sobrecarga de contexto.
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    Adicione o marketplace de skills Dodo Payments ao Claude Code:

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

    Então, instale plugins individuais:

    ```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">
    As skills estão automaticamente disponíveis quando configuradas nas suas configurações do OpenCode. Adicione o repositório de skills Dodo Payments à sua configuração:

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

## Usando Skills

Uma vez instaladas, seu assistente de IA pode aproveitar essas skills quando você pedir para implementar recursos do Dodo Payments. Aqui estão alguns exemplos de prompts:

### Melhores Práticas

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

### Webhooks

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

### Assinaturas

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

### Checkout

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

### Cobrança Baseada em Uso

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

### BillingSDK

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

### Chaves de Licença

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

### Cobrança Baseada em Crédito

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

## Como as Skills Funcionam

As skills fornecem ao seu assistente de IA:

1. **Conhecimento Procedural** - Instruções passo a passo para a implementação de recursos
2. **Templates de Código** - Padrões de código prontos para produção e snippets
3. **Melhores Práticas** - Abordagens recomendadas para segurança, tratamento de erros e UX
4. **Consciência de Contexto** - Compreensão de como diferentes recursos do Dodo Payments trabalham juntos

Quando você pede ao seu assistente de IA para implementar um recurso, ele usa a skill relevante para:

* Entender a abordagem correta de implementação
* Gerar código preciso e funcional
* Seguir as convenções do Dodo Payments
* Lidar adequadamente com casos extremos e erros

<Note>
  As skills complementam o [Servidor MCP](/developer-resources/mcp-server) e o [Sentra](/developer-resources/sentra). Use o MCP para operações de API, Sentra para integração guiada e Skills para capacidades aprimoradas do assistente de IA.
</Note>

## Comparação com Outras Ferramentas

| Ferramenta       | Finalidade                                  | Melhor Para                                               |
| ---------------- | ------------------------------------------- | --------------------------------------------------------- |
| **Agent Skills** | Melhorar o conhecimento do assistente de IA | Desenvolvimento assistido por IA com qualquer cliente MCP |
| **Servidor MCP** | Executar operações de API                   | Acesso direto à API de assistentes de IA                  |
| **Sentra**       | Assistente de integração guiada             | Integração de faturamento interativa em IDE               |

## Recursos

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/dodopayments/skills">
    Navegue pelo código-fonte e contribua para as skills do Dodo Payments
  </Card>

  <Card title="MCP Server" icon="server" href="/developer-resources/mcp-server">
    Habilite assistentes de IA para executar operações da API do Dodo Payments
  </Card>

  <Card title="Sentra" icon="wand-magic-sparkles" href="/developer-resources/sentra">
    Assistente de faturamento com tecnologia de IA para seu IDE
  </Card>

  <Card title="Discord Community" icon="discord" href="https://discord.gg/bYqAp4ayYh">
    Obtenha ajuda e compartilhe feedback com a comunidade
  </Card>
</CardGroup>