Skip to main content

​
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

​
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ópicoO que cobre
LGPDTratamento de dados pessoais, consentimento, direitos do titular
PCI-DSSNunca armazenar dados de cartão, tokenização, HTTPS obrigatório
BACENRegras do Banco Central para PIX, limites, horários
WebhooksValidação de assinatura, idempotência, retry handling

​
Configuração por Ferramenta

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.

​
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",
  },
);

​
Recursos

Repositório GitHub

Código-fonte e skills disponíveis

MCP Server

Conecte ferramentas de pagamento ao agente

​
Próximos Passos

Node SDK

Referência completa da SDK

Integrações

Configure sua ferramenta favorita