Integração com assistentes de IA

Qual é a habilidade

Uma habilidade é uma pasta com um arquivo SKILL.md que o assistente de IA carrega quando a tarefa se encaixa na descrição. Wealth Reader publicar uma em formato aberto Habilidades de Agente, sob a licença MIT, no repositório público https://github.com/Wealth-Reader/wealthreader-skills.

A wealthreader-integration de habilidade cobre:

• A integração do widget e do callback no backend.
• Autenticação de redirecionamento (OAuth) para aplicativos nativos.
• Atualizando dados com token de conexão e tratamento de erros.

Não cobre a iniciação de pagamentos nem o desenvolvimento de conectores bancários. Também não substitui o registro da conta do cliente: você ainda precisará configurar seu api_key, domínio autorizado e URL callback no Painel de Controle.

A mesma pasta funciona em Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro e qualquer outro assistente de IA que lea SKILL.md.

Instalação em um comando

npx skills add Wealth-Reader/wealthreader-skills

O instalador detecta os assistentes que você tem e permite que você escolha onde copiar a habilidade. Você também pode usar o instalador próprio da sua ferramenta:

# GitHub CLI
gh skill install Wealth-Reader/wealthreader-skills wealthreader-integration --agent claude-code --scope user

# Gemini CLI
gemini skills install https://github.com/Wealth-Reader/wealthreader-skills.git --consent

# Amp
amp skill add https://github.com/Wealth-Reader/wealthreader-skills --global

Instalação manual

Copie o repositório skills/wealthreader-integration/ a pasta para o diretório que seu assistente de IA lê e abra uma nova sessão. .agents/skills/ (projeto) e ~/.agents/skills/ (usuário) são os caminhos compartilhados que a maioria dos assistentes de IA lê. Claude Code, Cline e Kiro apenas leem seu próprio diretório.

Os caminhos foram verificados com a documentação pública de cada ferramenta em 5 de setembro de 2026. A tabela atualizada está sempre no repositório README .

Como usá-lo

Peça integração na linguagem e framework da sua aplicação. Um exemplo de pedido:

Use a habilidade wealthreader-integration para adicionar o widget Wealth Reader e o callback backend ao meu app. Recupere contas e transações e teste localmente sem fazer nenhum pedido bancário real.

A habilidade guia o assistente de IA pelos contratos documentados neste guia, em vez de improvisar a partir de outros API ou OAuthde open banking. Para cada fluxo, leia a página correspondente:

• Widget e callback: Iframe: frontend e Iframe: backend.
• Redirecionamento: OAuth: backend.
• Atualização de Dados e Erros: O API referência e o Catálogo de Erros.

O que ele verifica e o que não verifica

• Gera testes locais com dados sintéticos e com os usuários de teste do widget (MOCKDATA, MOCKOTP, MOCKLOGINKO). Não executa conexões bancárias reais por conta própria.
• Verifica se os dados recebidos pelo callback são armazenados de forma persistente antes da resposta {"status":"ok"}, se as mensagens postMessage são filtradas por origem e se credenciais inválidas não entram em ciclos de nova tentativa.
• Aponte controles de produção que essa documentação não corrige, como a autenticidade do callback, em vez de inventá-los. Resolva-os com Apoio antes de entrar em produção.

Manutenção

A habilidade é desenvolvida apenas a partir da documentação pública e links para as fontes de cada contrato. Se você detectar uma discrepância com este guia, abra um chamado no Repositório.