Integración con asistentes de IA

Qué es la skill

Una skill es una carpeta con un fichero SKILL.md que el asistente de IA carga cuando la tarea encaja con su descripción. Wealth Reader publica una en formato abierto Agent Skills, con licencia MIT, en el repositorio público https://github.com/Wealth-Reader/wealthreader-skills.

La skill wealthreader-integration cubre:

• La integración del widget y del callback en el backend.
• La autenticación por redirección (OAuth) para apps nativas.
• La actualización de datos con el token de la conexión y la gestión de errores.

No cubre la iniciación de pagos ni el desarrollo de conectores bancarios. Tampoco sustituye el alta como cliente: seguirás necesitando tu api_key, el dominio autorizado y la URL de callback configurados en el área de cliente.

La misma carpeta funciona en Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro y cualquier otro asistente de IA que lea SKILL.md.

Instalación en un comando

npx skills add Wealth-Reader/wealthreader-skills

El instalador detecta los asistentes que tienes y te deja elegir dónde copiar la skill. También puedes usar el instalador propio de tu herramienta:

# 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

Instalación manual

Copia la carpeta skills/wealthreader-integration/ del repositorio en el directorio que lee tu asistente de IA y abre una sesión nueva. .agents/skills/ (proyecto) y ~/.agents/skills/ (usuario) son las rutas compartidas que leen la mayoría de asistentes de IA. Claude Code, Cline y Kiro solo leen su propio directorio.

Las rutas se comprobaron contra la documentación pública de cada herramienta el 5 de septiembre de 2026. La tabla actualizada está siempre en el README del repositorio.

Cómo usarla

Pide la integración en el lenguaje y el framework de tu aplicación. Un ejemplo de petición:

Usa la skill wealthreader-integration para añadir el widget de Wealth Reader y el callback del backend a mi aplicación. Recupera cuentas y movimientos y pruébalo en local sin hacer peticiones bancarias reales.

La skill guía al asistente de IA por los contratos documentados en esta guía en lugar de improvisar a partir de otras API de open banking u OAuth. Para cada flujo lee la página correspondiente:

• Widget y callback: Iframe: frontend e Iframe: backend.
• Redirección: OAuth: backend.
• Actualización de datos y errores: la referencia de la API y el catálogo de errores.

Qué comprueba y qué no

• Genera pruebas locales con datos sintéticos y con los usuarios de prueba del widget (MOCKDATA, MOCKOTP, MOCKLOGINKO). No ejecuta conexiones bancarias reales por su cuenta.
• Verifica que el callback persiste antes de responder {"status":"ok"}, que los mensajes postMessage se filtran por origen y que las credenciales inválidas no entran en bucles de reintento.
• Señala los controles de producción que esta documentación no fija, como la autenticidad del callback, en lugar de inventarlos. Resuélvelos con Soporte antes de salir a producción.

Mantenimiento

La skill se elabora solo a partir de documentación pública y enlaza las fuentes de cada contrato. Si detectas una discrepancia con esta guía, abre una incidencia en el repositorio.