La localizzazione sta diventando una skill per agent, non un SDK

Localizzare un’app significava aggiungere un SDK, collegare un provider e gestire le chiavi a mano. Con gli agent di coding basati su IA c’è una strada più breve: installi una skill e l’agent si occupa del wiring. globalize.now è un’infrastruttura di localizzazione basata su IA, distribuita come skill open per agent. Esegui un comando, l’agent legge il playbook e la tua codebase ottiene una struttura pronta per la traduzione, senza dover mantenere nuovo plumbing.

Cos’è una skill per agent?

Una skill per agent è un piccolo pacchetto di istruzioni che un agent di coding legge ed esegue. Viene distribuita nell’ecosistema open delle skill e installata con la CLI delle skill, ad esempio npx skills add owner/repo. Lo stesso comando funziona con Claude Code, Cursor, Codex, OpenCode e oltre cinquanta altri agent.

La skill è un file SKILL.md più eventuali file di supporto e viene installata nella directory che il tuo agent controlla già. La CLI la collega a una singola copia canonica e registra l’installazione in un lockfile, così la skill viene versionata insieme al resto del progetto invece di vivere nell’account di un vendor. Esiste anche un registro pubblico: puoi trovare, leggere e fissare una skill come qualsiasi altra dipendenza.

Il cambiamento da notare è questo: una skill non è un prodotto con cui il tuo agent si integra. È conoscenza che l’agent assimila e applica al tuo codice. La differenza si vede appena aggiungi una persona al team. Clona il repository, trova già la skill e il suo agent gestisce la localizzazione come fa il tuo.

Perché distribuire i18n come skill invece che come SDK?

Perché la parte difficile dell’internazionalizzazione è il refactor, e una skill insegna al tuo agent a farlo al posto tuo. Un SDK presuppone che il codice sia già strutturato per la traduzione. Devi comunque trovare le stringhe hardcoded, definire uno schema per le chiavi, creare i file locale e collegare la libreria di runtime.

Le app create con l’IA peggiorano il problema, perché gli agent di coding ottimizzano per una schermata funzionante, non per un’architettura pronta alla traduzione. Il risultato di solito è corretto e pronto per il rilascio, ma pieno di stringhe come <button>Submit order</button> invece di chiamate basate su chiavi. Moltiplica il problema per tutto il progetto e il lavoro di localizzazione diventa un refactor, non una modifica di configurazione.

Se lo lasci irrisolto, il problema si accumula. La stessa label viene scritta in tre modi leggermente diversi, i conteggi vengono renderizzati come 1 messages e, quando aggiungi la prima lingua, scopri schermate metà in inglese e metà in un’altra lingua. Una skill è progettata per intercettare tutto in un unico passaggio, prima che si trasformi in cento piccoli ticket.

Una skill codifica quel refactor in istruzioni che il tuo agent può eseguire. Rileva il framework, conferma il runtime i18n che usi già, come next-intl o i18next, estrae le stringhe inglesi e genera chiavi e file locale. Non importi un nuovo runtime da versionare e mantenere. La skill configura tutto e poi si fa da parte.

In cosa differisce una skill da un server MCP?

Un server MCP è un servizio che il tuo agent chiama; una skill è semplicemente un insieme di file nel progetto. Il Model Context Protocol è un buon modo per fornire agli agent strumenti e dati aggiornati tramite un server in esecuzione. Ma un server deve essere ospitato da te o da un vendor e il tuo agent dipende dal fatto che sia raggiungibile.

Una skill non ha alcun servizio dietro. È testo e codice che vivono nel repository, funziona senza chiamate di rete e compare in una pull request come qualsiasi altra modifica. Per attività di configurazione una tantum, come internazionalizzare una codebase, i file sono meglio di un servizio che devi tenere attivo. Leggi cosa farà la skill, la esegui e revisioni il diff.

Le skill si combinano. Puoi installarne diverse e tenerle affiancate, perché ognuna contiene solo istruzioni, non un altro processo da eseguire e pagare.

Come si installa globalize.now come skill per agent?

Un comando e il tuo agent fa il resto.

npx skills add globalize-now/globalize-skills --all

Il flag --all installa ogni skill per ogni agent sulla tua macchina: è l’impostazione predefinita più sicura se non sai quale agent stai usando. La CLI installa la skill di globalize.now nel percorso in cui il tuo agent cerca le skill. Funziona con l’agent che usi già, inclusi Claude Code e Cursor.

Da lì, chiedi al tuo agent di configurare i18n e lui segue il playbook: rileva il framework, conferma la libreria di runtime, trova le stringhe inglesi visibili agli utenti e genera chiavi e file locale. È il prima e dopo che gli sviluppatori riconoscono subito.

// before
<button>Submit order</button>

// after
<button>{t("checkout.submit_order")}</button>

Le chiavi finiscono nei file locale che la skill crea e mantiene per te:

/locales
  en.json
  de.json
  es.json
  fr.json

Il file inglese viene popolato con le stringhe trovate dall’agent. Le altre lingue vengono generate e mantenute aggiornate a ogni push, così aggiungere un mercato significa aggiungere un file locale, non aprire uno sprint.

Dopo la configurazione, le traduzioni si sincronizzano a ogni push su Git. Non devi esportare nulla e non c’è nessuna coda da svuotare. Se stai creando la tua app con il vibe coding, questo è tutto il lavoro. Se sei uno sviluppatore che vuole i dettagli, la stessa skill esegue il refactor in modo pulito e ti lascia file locale standard.

Le mie traduzioni restano nel repository?

Sì. I file locale generati dalla skill vengono committati nel repository come qualsiasi altro file sorgente. È l’aspetto più importante per evitare il lock-in.

Alcuni approcci spostano le stringhe tradotte in uno step di build o in una dashboard ospitata, così quando te ne vai se ne va anche il tuo layer di traduzione. Con i file locale nativi del repository, en.json, de.json e tutti gli altri sono semplici file del progetto. La skill potrebbe sparire domani e la tua app continuerebbe a rilasciare tutte le lingue già presenti. Per andartene basta non installare più la skill: non c’è nulla da migrare, perché i tuoi dati non sono mai stati altrove. È per questo che globalize.now si colloca nel layer infrastrutturale del tuo stack: genera chiavi e file locale invece di avvolgersi intorno alla tua app.

Il modello basato sulle skill ti vincola a un vendor?

No, ed evitare il lock-in è proprio il motivo per preferirlo. La skill viene installata da un registro open che qualsiasi agent supportato può leggere, non da un plugin store chiuso. L’output è costituito da file locale standard per la libreria di runtime che hai già scelto, non da un formato proprietario da smontare in seguito.

Puoi leggere esattamente cosa fa la skill prima di eseguirla, perché è fatta solo di file. Se vuoi la procedura completa invece dell’argomentazione, la guida come localizzare un’app generata dall’IA illustra la stessa configurazione dall’inizio alla fine.