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

# Skills para Agentes

> Ensine boas práticas de pagamento ao seu agente de IA com as skills da Garu

## O que são Skills?

Skills são pacotes de conhecimento que ensinam agentes de IA a escrever código de pagamento seguindo boas práticas. Com as skills da Garu, seu agente sabe como:

* Usar a SDK corretamente
* Seguir regras de compliance (LGPD, PCI-DSS, BACEN)
* Tratar erros de pagamento
* Validar webhooks com segurança

> [!NOTE]
>
> **Pré-requisito:** Você precisa de uma chave de API. Veja como obter em
> [Autenticação](https://docs.garu.com.br/api-reference/autenticacao.md).

> [!TIP]
>
> Skills complementam o [MCP Server](https://docs.garu.com.br/guias/mcp-server.md). O MCP dá ao agente
> **ferramentas** para agir; as skills dão **conhecimento** para agir bem.

## Instalação

```bash theme={null}
npx skills add Garu-Pagamentos/garu-skills
```

## Skills Disponíveis

### `garu-sdk`

Skill principal que funciona como roteador para as sub-skills. Ensina o agente a:

* Inicializar o cliente da SDK
* Criar cobranças com os parâmetros corretos
* Gerenciar clientes (CRUD)
* Usar chaves de idempotência
* Tratar erros da API

### `payment-best-practices`

Boas práticas e compliance para pagamentos no Brasil:

| Tópico | O que cobre |
| - | - |
| **LGPD** | Tratamento de dados pessoais, consentimento, direitos do titular |
| **PCI-DSS** | Nunca armazenar dados de cartão, tokenização, HTTPS obrigatório |
| **BACEN** | Regras do Banco Central para PIX, limites, horários |
| **Webhooks** | Validação de assinatura, idempotência, retry handling |

## Configuração por Ferramenta

> [tab] Claude Code
>
> As skills são instaladas automaticamente em `.claude/skills/` no seu projeto:
>
> ```
> .claude/
> └── skills/
>     ├── garu-sdk.md
>     └── payment-best-practices.md
> ```
>
> O Claude Code carrega as skills automaticamente ao trabalhar no projeto.

> [tab] Cursor
>
> As skills são instaladas em `.cursor/` no seu projeto:
>
> ```
> .cursor/
> └── rules/
>     ├── garu-sdk.mdc
>     └── payment-best-practices.mdc
> ```
>
> O Cursor carrega as rules automaticamente.

> [tab] Codex
>
> As skills são adicionadas ao arquivo `AGENTS.md` na raiz do projeto. O Codex lê esse arquivo automaticamente.

## Exemplo na Prática

Sem skills, um agente pode gerar código assim:

```javascript theme={null}
// ❌ Sem skills — código inseguro
const response = await fetch("https://garu.com.br/api/charges", {
  method: "POST",
  headers: { Authorization: "Bearer sk_live_abc123" }, // chave hardcoded!
  body: JSON.stringify({ amount: 49.9 }), // sem idempotência
});
```

Com skills, o agente gera código correto:

```javascript theme={null}
// ✅ Com skills — boas práticas aplicadas
import { Garu } from "@garuhq/node";

const garu = new Garu({ apiKey: process.env.GARU_API_KEY });

const charge = await garu.charges.create({
  productId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890", // o preço vem do produto
  paymentMethod: "pix",
  customer: {
    name: "João Silva",
    email: "joao@email.com",
    document: "12345678909",
    phone: "11987654321",
  },
  idempotencyKey: "order_12345",
});
```

## Recursos

> [card] [Repositório GitHub](https://github.com/Garu-Pagamentos/garu-skills)
>
> Código-fonte e skills disponíveis

> [card] [MCP Server](https://docs.garu.com.br/guias/mcp-server.md)
>
> Conecte ferramentas de pagamento ao agente

## Próximos Passos

> [card] [Node SDK](https://docs.garu.com.br/guias/node-sdk.md)
>
> Referência completa da SDK

> [card] [Integrações](https://docs.garu.com.br/guias/integracoes/cursor.md)
>
> Configure sua ferramenta favorita


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.