Integrazione con assistenti AI

Qual è l'abilità

Una competenza è una cartella con un file SKILL.md che l'assistente AI carica quando il compito corrisponde alla sua descrizione. Wealth Reader ne pubblica una in formato aperto Agent Skills, licenziato dal MIT, nel repository pubblicohttps://github.com/Wealth-Reader/wealthreader-skills.

La competenza wealthreader-integration comprende:

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

Non copre l'avvio del pagamento né lo sviluppo di connettori bancari. Non sostituisce nemmeno la registrazione del cliente: dovrai comunque configurare il dominio api_keyautorizzato e l'URL di callback nell'area client.

La stessa cartella funziona in Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro e in qualsiasi altro wizard AI che tu leggaSKILL.md.

Installazione di 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 la cartella skills/wealthreader-integration/ del repository nella directory che il tuo assistente AI legge e apri una nuova sessione. .agents/skills/ (project) e ~/.agents/skills/ (user) 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 verificati rispetto alla documentazione pubblica di ciascun strumento il 5 settembre 2026. La tabella aggiornata è sempre nel README repository.

Come usarlo

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

Uso l'abilità di integrazione wealthreader per aggiungere il widget Wealth Reader e il backend callback alla mia applicazione. Recupero conti e transazioni e testalo localmente senza fare richieste bancarie reali.

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

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

Cosa controlla e cosa non controlla

• Genera test locali con dati sintetici e con gli utenti di test del widget (MOCKDATA, , MOCKOTP``MOCKLOGINKO). Non gestisce connessioni bancarie reali da sola.
• Verificare che il callback persista prima di{"status":"ok"} rispondere, che i messaggi postMessage siano filtrati per sorgente e che credenziali invalide non entrino nei cicli di ritento.
• Indicare i controlli di produzione che questa documentazione non corregge, come l'autenticità del callback, invece di inventarli. Risolverli con Supporto prima di entrare in produzione.

Manutenzione

La competenza si basa solo sulla documentazione pubblica e sui link alle fonti di ogni contratto. Se noti una discrepanza con questa guida, apri un ticket nel repository.