Scriviamo skill da secoli. Li chiamavamo libri.

Blog · 5 min di lettura

Chiedete a qualcuno di «scrivere uno skill» per il proprio agente IA e vedrete comparire uno strano panico da palcoscenico, come se fosse un tipo di scrittura che nessuno ha mai fatto prima. Non lo è. Una ricetta è uno skill. Un manuale da campo è uno skill. La scheda di sicurezza plastificata dietro il sedile dell'aereo, il runbook degli incidenti nel raccoglitore delle operazioni, la guida di stile che il vostro primo caporedattore vi ha fatto leggere due volte — tutto questo è la stessa cosa che oggi cerchiamo di affidare a un agente: ecco come si fa questa cosa, scritto perché qualcun altro possa farla senza di voi nella stanza.

Quello che è davvero nuovo non è la scrittura. È il lettore. Un libro di cucina è scritto per qualcuno che lo sfoglia una volta, decide cosa preparare per cena, magari legge l'aneddoto introduttivo per il gusto della storia. Un agente non vuole la storia. Vuole la temperatura del forno, il tempo di lievitazione, il «se l'impasto non è raddoppiato, aspetta altri venti minuti, non indovinare». Le buone istruzioni hanno sempre contenuto questa parte da qualche parte — l'abbiamo solo sepolta sotto tutto quello che voleva anche un lettore umano, e un agente ha bisogno che venga dissepolta.

La parte in cui sbagliavo

Per un periodo, «scrivere uno skill» significava per me qualcosa di molto simile alla traduzione, e ci ero negato: leggere un capitolo, tenere a mente i punti importanti, riscriverli in una casella di testo. Tenevo la frase che suonava autorevole e perdevo il numero esatto due paragrafi dopo, perché a quel punto avevo smesso di prendere appunti. Quello che ne usciva era l'atmosfera dell'originale, non l'originale — sicuro di sé in apparenza, e silenziosamente sbagliato in un modo che non notavo finché un agente non lo seguiva in un posto che non mi aspettavo.

L'alternativa che ho provato dopo era peggiore: incollare l'intero capitolo e sperare che l'agente trovasse il paragrafo giusto sotto pressione, come consegnare a qualcuno un manuale di quaranta pagine dicendo «è lì dentro da qualche parte». Nessuna delle due cose è davvero scrivere uno skill. Una butta via la fonte. L'altra si rifiuta di fare il lavoro di trasformarla in uno skill.

Cosa è cambiato

La funzione di Skilnu che genera una bozza da un documento fa esattamente ciò in cui ero negato: legge il documento vero e proprio — un PDF, un file Word, un'esportazione Markdown — e restituisce una bozza di SKILL.md che mantiene i dettagli invece dell'atmosfera. Non viene pubblicato nulla. È una prima stesura che resta nel modulo di composizione, in attesa che io corregga ciò che ha capito male prima che qualcun altro, a valle, la veda.

L'abitudine che è cambiata è più piccola di quanto sembri. Ho smesso di chiedermi «come lo spiego a un agente» e ho iniziato a chiedermi «non l'ho già scritto da qualche parte?». Sempre più spesso sì: il documento di onboarding scritto da un ex collega che nessuno ha più riaperto da allora, la guida di stile che viveva come un PDF che nessuno leggeva oltre la prima pagina, un capitolo di un libro che continuo a consigliare a voce invece di prestarlo e basta. Ognuno di questi si è rivelato a venti minuti e una revisione di distanza dal diventare qualcosa che un agente poteva davvero seguire — non solo qualcosa che potevo citare male a memoria.

Niente di tutto questo rende le bozze prive di bisogno di revisione. Un modello che ha letto il vostro documento una sola volta scrive ancora come tale: inserisce un riassunto dove serviva una regola, resta vago esattamente dove la fonte era vaga. Quella parte resta compito vostro, proprio come è sempre stato compito di chiunque adatti un manuale per un nuovo lettore. Quello che è sparito è la pagina bianca, e lo sforzo di ricordare cosa dicesse davvero il capitolo quattro.

Il vostro scaffale ne è già pieno

L'istinto di scrivere uno skill da zero tratta ogni istruzione per un agente come un tipo di documento completamente nuovo. Non lo è. Da qualche parte nel wiki del vostro team, in un raccoglitore nell'armadio delle operazioni, o su uno scaffale vero, la maggior parte di ciò che vorreste che un agente sapesse è già scritta da qualcuno a cui importava abbastanza da farlo bene la prima volta. Il compito non è mai stato scriverlo. È finalmente ammettere che il manuale conta.