L’obiezione, detta prima che la pensi tu
«Le Skill sono ufficiali, e sono già dei file miei»
Vero su tutta la linea, e non proviamo a girarci intorno. Una Skill è una cartella con dentro un SKILL.md: due righe di intestazione — un nome e una descrizione — e poi testo. È markdown, è tuo, sta in git, e se domani cambi idea te lo porti via. Nessuno ti ha chiuso dentro niente.
Anche il meccanismo è ben pensato. Finché la Skill non serve, di lei sta in memoria solo la descrizione — un centinaio di parole; il corpo si carica quando l’IA decide che è pertinente, e i file di appoggio solo se li apre davvero. Si chiama divulgazione progressiva, ed è il modo giusto di dare a un’IA cento competenze senza pagarle tutte a ogni frase.
Quindi no: questa pagina non esiste per dirti che le Skill sono fatte male. Esiste perché quel meccanismo, che per una capacità è una virtù, per un’identità è il difetto.
Il punto è quando entra in contesto
Una Skill entra quando serve. È tutta la sua eleganza: non occupa posto finché non c’è un motivo, e il motivo lo riconosce l’IA leggendo la descrizione. Perfetto per «impaginare una presentazione secondo le nostre regole», che serve il martedì e non il giovedì.
Un’identità non funziona così. Chi sei non è una competenza che si attiva quando l’argomento lo richiede: è la cosa che c’è già prima che tu apra bocca, e che decide come leggi la domanda. Una cosa che compare solo quando viene invocata non è un carattere, è un manuale.
È la stessa differenza che passa fra sapere cucinare e avere fame. La prima si tira fuori all’occorrenza; la seconda ti muove anche quando non stai pensando al cibo.
E poi c’è una cosa che una Skill non ha
In un SKILL.md non esiste modo di scrivere questa parte non la puoi riscrivere tu. Non è una dimenticanza: una Skill è roba che dai all’IA perché la usi, e non c’è niente da difendere.
In un Reminder invece dall’altra parte c’è qualcuno che legge, capisce e potrebbe riscrivere — e allora ogni blocco dichiara quanto è tuo: dalle regole che solo tu puoi cambiare fino agli appunti che l’IA aggiorna senza chiedere. È la differenza fra un manuale e una costituzione, ed è anche il motivo per cui il Reminder ha una struttura invece di essere prosa.
In due colonne
| | Una Skill | Un Reminder |
|---|
| A cosa risponde | come si fa una cosa | chi è chi la fa |
| Quando entra in contesto | quando l’IA la giudica pertinente | sempre, dalla prima riga |
| Cosa contiene | una procedura, degli esempi, degli script | nuclei, moduli, memorie, permessi |
| Chi può riscriverla | tu, fuori dalla conversazione | dipende dalla zona: è dichiarato dentro il file |
| Se la togli | l’IA smette di saper fare quella cosa | l’IA smette di essere qualcuno |
| Cosa ricorda | niente: domani è uguale a oggi | com’è andata: nella memoria associata del modulo |
Dove stanno insieme, che è quasi sempre
Non è un aut aut e non conviene farlo diventare tale. La divisione che funziona è netta: le Skill per le capacità, il Reminder per l’identità. Stessa conversazione, nessun conflitto — perché non si contendono lo stesso posto.
Con gli agenti da codice la stessa divisione ha già un posto suo: il file che l’agente legge all’avvio — CLAUDE.md, AGENTS.md — è dove va l’identità, e le Skill restano le procedure che quell’identità sa eseguire.
E il confine è più poroso di quanto sembri. Una Skill che hai già si traduce in un modulo, quasi riga per riga: non c’è niente da reinventare, perché le due forme rispondono alle stesse quattro domande.
- La descrizione: cosa fa, e quando usarla
→- ### FUNCTION · ### TRIGGER
- Le istruzioni, i passi da seguire
→- ### ROUTINE
- Le cose da non fare, i limiti
→- ### LIMITI
- Gli esempi di input e output
→- ### ESEMPIO
Vale anche nell’altro verso, ed è la parte che sorprende. Di obbligatorio, in un SKILL.md, ci sono due righe di intestazione — un nome e una descrizione. Sotto sei libero: la struttura del corpo non è prescritta da nessuno. Che le Skill si scrivano a prosa sciolta è un’abitudine diffusa, non una regola — e le linee guida di Anthropic stesse consigliano passi numerati, modelli di output ed esempi, cioè esattamente la forma che un modulo ha già. Sotto il frontmatter ci sta senza riscritture.
Una cosa sola non attraversa, e conviene dirla. Dentro un modulo la riga che dichiara questa parte non la riscrivi tu ha un posto suo, e l’app la fa rispettare; dentro un SKILL.md quella riga non ha dove stare, e nessuna app è nel giro a difenderla — i marcatori di zona restano lì come testo, e nessuno li applica. Tradurre una capacità funziona benissimo. Tradurre l’identità no: ed è tutto quello che questa pagina sta dicendo.
Il terzo modo: non tradurla, innestarla
Tradurre una Skill in un modulo è una strada. L’altra è non tradurla affatto. Il corpo di un SKILL.md è markdown, e un modulo lo ospita così com’è, sotto una riga che dichiara di chi è quel pezzo: nello Standard si chiama ### SUB-MODULE:, e sotto ci va il testo intero della Skill — la sua funzione, i suoi passi, i suoi esempi. Non si riscrive niente. Si dice di chi è, e dove sta.
## MODULE 07: ...
### FUNCTION
### SUB-MODULE: SKILL_A
#### FUNCTION
#### ROUTINE
### SUB-MODULE: SKILL_B
#### FUNCTION
#### ROUTINE
[P4]
### ASSOCIATED MEMORY
[/P4]
Quello che il modulo aggiunge attorno sono le due cose che in un SKILL.md non hanno dove stare. La prima è la zona di permesso: il testo innestato finisce dentro un blocco che dichiara chi lo può riscrivere, e quel rifiuto lo fa l’app, non il modello. La seconda è ### ASSOCIATED MEMORY, la sezione dove si deposita quello che impari usandola — che quei passi da te vanno fatti in un altro ordine, che con i tuoi file quel passaggio non regge, che l’output lo vuoi più corto. La Skill sa come si fa. Il modulo si ricorda com’è andata.
E in un modulo ne sta più di una. Se tre Skill lavorano allo stesso mestiere — leggere un PDF, tirarne fuori una tabella, scriverne il riassunto — puoi innestarle nello stesso modulo, una per ### SUB-MODULE:. Da lì in poi non si accendono più a una a una: entrano in contesto insieme, quando entra il modulo, e si vedono fra loro. È una scelta tua, ed è il momento in cui smetti di fare divulgazione progressiva.
Il prezzo è dichiarato: le paghi tutte e tre ogni volta che quel modulo è attivo, anche il giorno che te ne serviva una. Quello che compri è che smettono di contraddirsi — una memoria associata invece di tre, una regola scritta una volta invece della stessa frase in tre posti, e nessun lavoro fatto a metà perché l’IA ne aveva caricata una e non l’altra. Se il mestiere è uno, il modulo è uno. Se i mestieri sono tre, tienile separate e lascia che si accendano quando servono: è esattamente il caso in cui la Skill da sola fa il suo lavoro meglio di così.
Una cosa la fai a mano, oggi, e conviene saperlo prima: l’innesto è un copia e incolla, e da quel momento la copia è tua. Se l’autore della Skill ne pubblica una versione nuova, sei tu a decidere se portarla dentro — il testo sta lì in chiaro, dentro il tuo file, e si aggiorna come si aggiorna un file. È lo stesso patto del resto: sotto di te non si muove niente che tu non veda.
In una riga
Una Skill è una cosa che la tua IA sa fare. Un Reminder è chi è mentre la fa. Tienile tutte e due: non si pestano i piedi, perché non stanno nello stesso posto.