Habilidades do Agente

Habilidades do Agente são pastas de instruções, melhores práticas e recursos que agentes de codificação de IA — como Claude Code, Cursor e GitHub Copilot — podem descobrir e carregar sob demanda. A Pluggy mantém um conjunto de habilidades oficiais para que, quando você pede ao seu agente para construir ou revisar uma integração Pluggy, ele siga os padrões documentados da Pluggy em vez de adivinhar.

As habilidades seguem o formato aberto de Habilidades do Agente e são de código aberto em pluggyai/agent-skills.

Habilidades vs. MCP

O Servidor MCP dá a um agente acesso ao vivo à documentação e referência da API da Pluggy em tempo de execução. Habilidades dão ao agente o conhecimento — os padrões, o que fazer e o que não fazer — para usar a Pluggy corretamente. Elas são independentes: as habilidades funcionam por conta própria, sem necessidade de MCP. Elas também funcionam muito bem juntas — o Pluggy Doctor, por exemplo, valida contra a documentação através do MCP quando está conectado (e recorre à documentação pública na web quando não está).

Instalação#

Instale todas as habilidades da Pluggy em seu projeto com um único comando:

npx skills add pluggyai/agent-skills

ou

pnpm dlx skills add pluggyai/agent-skills

Uma vez instaladas, as habilidades estão disponíveis automaticamente. Seu agente carrega a relevante sempre que detecta uma tarefa correspondente — você não precisa invocá-las manualmente. Nenhum MCP é necessário — as habilidades são autossuficientes.

Opcional, recomendado para o Pluggy Doctor: conecte o Pluggy Docs MCP para que o revisor valide contra a documentação ao vivo. Se você pular isso, o Pluggy Doctor recorre à documentação pública na web.

claude mcp add --transport http pluggy-docs https://docs.pluggy.dev/api/mcp

Habilidades disponíveis#

pluggy-integration#

Padrões e melhores práticas de integração da Pluggy — a base para qualquer implementação.

Use quando você estiver:

• Configurando o SDK da Pluggy e autenticação
• Implementando o Connect Widget em um aplicativo frontend
• Criando, atualizando ou excluindo Items (conexões)
• Configurando webhooks para sincronização de dados em tempo real
• Lidando com fluxos de MFA e erros de conexão

Áreas cobertas:

Exemplos de prompts:

Ajude-me a integrar o Connect Widget da Pluggy no meu aplicativo React
Configurar webhooks para sincronizar dados de transações
Como devo lidar com MFA quando um Item está WAITING_USER_INPUT?

pluggy-open-finance#

Melhores práticas para recuperar e gerenciar dados de Open Finance através da Pluggy.

Use quando você estiver:

• Selecionando o conector certo para uma instituição financeira
• Recuperando saldos e detalhes de contas
• Buscando e processando transações
• Acessando portfólios de investimento, empréstimos ou dados de identidade
• Projetando uma estratégia de sincronização de dados

Áreas cobertas:

Exemplos de prompts:

Buscar e armazenar transações com paginação para um Item
Enriquecer transações com categorias
Qual é a estratégia de sincronização correta após um webhook de item/atualizado?

pluggy-payments#

Iniciação de pagamento com PIX, Boleto e Smart Transfers.

Use quando você estiver:

• Iniciando pagamentos PIX
• Criando e gerenciando Boletos
• Configurando Smart Transfers com pré-autorização
• Gerenciando o ciclo de vida da intenção de pagamento
• Lidando com pagamentos agendados (PIX Agendado)

Áreas cobertas:

Exemplos de prompts:

Implementar a iniciação de pagamento PIX de ponta a ponta
Configurar uma Smart Transfer com pré-autorização
Rastrear o status do pagamento com webhooks

pluggy-doctor#

Uma habilidade de revisor que revisa o código de uma integração Pluggy existente e informa se está pronta para produção. Ao contrário das outras habilidades (que ajudam você a construir), o Pluggy Doctor avalia o código que você já escreveu.

Ele diagnostica contra a documentação oficial da Pluggy — nunca de memória ou de uma lista de verificação congelada — e retorna um relatório estruturado com uma correção para cada problema. Ele lê a documentação através do Pluggy MCP quando está conectado, e recorre à leitura da mesma documentação pública na web quando não está — então a habilidade funciona com ou sem o MCP. Se não conseguir confirmar um critério contra a documentação, marca como "não verificado" em vez de adivinhar.

Use quando você:

• Quiser revisar ou validar uma integração existente
• Perguntar "isso está pronto para produção?"
• Quiser verificar a segurança das credenciais, tokens de conexão ou tratamento de webhooks
• Fazer upload de arquivos de integração (manipulador de webhook, geração de token de conexão, configuração) para diagnóstico

Áreas cobertas:

• Segurança das credenciais (clientId/clientSecret apenas no backend)
• Connect Token & clientUserId
• Webhooks — configuração
• Webhooks — tratamento correto (status do item, PARTIAL_SUCCESS, sincronização bidirecional)
• Estratégia de sincronização — confiar na sincronização automática, sem atualizações autônomas
• Ambiente (sandbox vs. produção)

O que você recebe de volta: um relatório por área classificando cada item como ✅ correto, ❌ problema (com arquivo, linha e uma correção pronta para colar), ⚠️ aviso, ou ➖ não aplicável — encerrando com um claro 🟢 pronto para produção ou 🔴 ainda não.

Nota: o relatório de diagnóstico reflete a linguagem do desenvolvedor.

Exemplos de prompts:

Revise minha integração Pluggy antes de enviá-la
Verifique meu manipulador de webhook — está correto?
Esta integração é segura e está pronta para produção?
Analisa minha integração da Pluggy

Agentes suportados#

As habilidades usam a nomenclatura de ferramentas do Claude Code, mas funcionam com qualquer agente que suporte o formato de Habilidades do Agente, incluindo:

• Claude Code
• Cursor
• GitHub Copilot

Recursos#

• Repositório de Habilidades do Agente (pluggyai/agent-skills)
• Servidor MCP da Pluggy
• Documentação da Pluggy
• Referência da API
• pluggy-js SDK