Skills para Agentes

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

Pré-requisito: Você precisa de uma chave de API. Veja como obter em Autenticação.

Skills complementam o MCP Server. O MCP dá ao agente ferramentas para agir; as skills dão conhecimento para agir bem.

Instalação

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

Claude Code
Cursor
Codex

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.

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.

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:

// ❌ 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:

// ✅ 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(
  {
    amount: 4990,
    method: "pix",
    customer: { email: "joao@email.com" },
  },
  {
    idempotencyKey: "order_12345",
  },
);

Primeiros Passos

Integrando Pagamentos

Ferramentas para Agentes

Integrações

Skills para Agentes

O que são Skills?

Instalação

Skills Disponíveis

`garu-sdk`

`payment-best-practices`

Configuração por Ferramenta

Exemplo na Prática

Recursos

Repositório GitHub

MCP Server

Próximos Passos

Node SDK

Integrações

​O que são Skills?

​Instalação

​Skills Disponíveis

​garu-sdk

​payment-best-practices

​Configuração por Ferramenta

​Exemplo na Prática

​Recursos

Repositório GitHub

MCP Server

​Próximos Passos

Node SDK

Integrações

O que são Skills?

Instalação

Skills Disponíveis

`garu-sdk`

`payment-best-practices`

Configuração por Ferramenta

Exemplo na Prática

Recursos

Próximos Passos