Integrazione con assistenti AI

Qual è l'abilità

Un'abilità è una cartella con un file SKILL.md che l'assistente AI carica quando il compito corrisponde alla sua descrizione. Wealth Reader pubblicarne una in formato open Competenze degli agenti, concesso in licenza dal MIT, nel repository pubblico https://github.com/Wealth-Reader/wealthreader-skills.

La wealthreader-integration di abilità copre il seguente:

• L'integrazione del widget e del callback nel backend.
• Autenticazione di reindirizzamento (OAuth) per le app native.
• Aggiornamento dei dati con token di connessione e gestione degli errori.

Non copre l'avvio dei pagamenti né lo sviluppo di connettori bancari. Non sostituisce nemmeno la registrazione dell'account cliente: dovrai comunque configurare il tuo api_key, il dominio autorizzato e callback URL nel Pannello di Controllo.

La stessa cartella funziona su Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro e su qualsiasi altro assistente AI che legga SKILL.md.

Installazione in un comando

npx skills add Wealth-Reader/wealthreader-skills

L'installer rileva i wizard che hai e ti permette di scegliere dove copiare l'abilità. Puoi anche usare l'installatore del tuo strumento:

# 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

Installazione manuale

Copia il repository skills/wealthreader-integration/ la cartella nella directory che il tuo assistente AI legge e apri una nuova sessione. .agents/skills/ (progetto) e ~/.agents/skills/ (utente) sono i percorsi condivisi che la maggior parte degli assistenti AI legge. Claude Code, Cline e Kiro leggono solo la loro directory.

I percorsi sono stati confrontati con la documentazione pubblica di ogni strumento il 5 settembre 2026. La tabella aggiornata si trova sempre nel repository README .

Come usarlo

Chiedi l'integrazione nel linguaggio e nel framework della tua applicazione. Un esempio di richiesta:

Usa la skill wealthreader-integration per aggiungere il widget Wealth Reader e il backend callback alla mia app. Recupera conti e transazioni e testa localmente senza fare reali richieste bancarie.

La competenza guida l'assistente AI attraverso i contratti documentati in questa guida invece di improvvisare da altri API o OAuthdi open banking. Per ogni flusso, leggi la pagina corrispondente:

• Widget e callback: Iframe: frontend e Iframe: backend.
• Reindirizzamento: OAuth: backend.
• Aggiornamento dei dati ed errori: API riferimento e il Catalogo degli errori.

Cosa controlla e cosa non controlla

• Genera test locali con dati sintetici e con gli utenti del test del widget (MOCKDATA, MOCKOTP, MOCKLOGINKO). Non gestisce vere connessioni bancarie da solo.
• Verifica che il callback persista prima di rispondere {"status":"ok"}, che i messaggi postMessage siano filtrati per sorgente e che le chiavi di accesso non valide non entrino nei cicli di ritento.
• Segnala i controlli di produzione che questa documentazione non corregge, come l'autenticità del callback, invece di inventarli. Risolvi con Supporto prima di entrare in produzione.

Manutenzione

La competenza viene sviluppata solo a partire dalla documentazione pubblica e dai collegamenti alle fonti di ogni contratto. Se rilevi una discrepanza con questa guida, apri un ticket nel Repository.