Skill per l'assistente IA: com'è fatto SKILL.md e come installarlo senza terminale

Che cos'è un file SKILL.md

SKILL.md è un file di testo con un'istruzione che un assistente IA legge prima di mettersi al lavoro. Non è un programma né un plugin: è normale markdown in cui si descrive come si svolge un certo tipo di lavoro — cosa controllare per primo, in che ordine ragionare, in quale forma consegnare il risultato, cosa non fare mai. Il file vive in un repository, l'assistente lo preleva e da quel momento il lavoro si fa come descritto, e non come improvvisa il modello.

Il formato è nato a fine 2025 e in pochi mesi è diventato comune: lo leggono Claude, Codex, Copilot, Cursor, Gemini CLI e decine di altri strumenti, e gli elenchi pubblici contano ormai le skill a centinaia di migliaia. Eppure quasi tutta la documentazione è scritta per chi ha un terminale, un repository e un agente di codice in esecuzione — l'unico motivo per cui l'argomento sembra ancora roba da sviluppatori.

Il file in sé è semplice. Due parti, separate da una riga di tre trattini.

Ecco una skill completa, di dimensioni realistiche. Descrive come analizzare la registrazione di una chiamata commerciale: cosa cercare, in che ordine e cosa non inventare.

---
name: sales-call-review
description: Analisi di una chiamata commerciale — obiezioni, segnali, prossimo passo
---

# Analisi di una chiamata commerciale

Stai analizzando la trascrizione di una chiamata con un potenziale cliente.

## Ordine di lavoro

1. Riporta le obiezioni ALLA LETTERA, fra virgolette. Non parafrasare:
   la formulazione esatta di un'obiezione è il dato.
2. Per ogni obiezione indica se è stata data una risposta e se è stata
   accettata. Il silenzio non è accettazione.
3. Cerca i segnali su budget, tempi e chi decide.
   Se un segnale non è emerso, scrivilo così: «non menzionato».
4. Definisci il prossimo passo: che cosa esattamente, chi lo fa, entro quando.

## Formato di uscita

Quattro sezioni nell'ordine di cui sopra. All'interno punti brevi,
senza paragrafi introduttivi. Le obiezioni citate fra virgolette.

## Cosa non fare

- Non attribuire intenzioni: solo ciò che è stato detto davvero.
- Non stimare la probabilità di chiusura in percentuale — non ci sono
  dati per farlo.
- Non proporre uno sconto come prossimo passo se del prezzo non si è
  mai parlato.

Nota che cosa nel file non c'è: né codice, né configurazione, né chiavi API, né comandi di installazione. Una skill è esperienza messa per iscritto, non software. Proprio per questo può scriverla chi non ha mai aperto un terminale — e proprio per questo è strano che installarla ne richieda ancora uno.

Skill, strumento e prompt: chi fa che cosa

Tre concetti che si confondono di continuo pur risolvendo problemi diversi. La differenza è più semplice di quanto sembri: il prompt fissa il ruolo, la skill fissa il metodo, MCP fornisce l'accesso.

Conseguenza pratica: se l'assistente risponde fuori tema, ti serve una skill. Se risponde bene ma non conosce i fatti, ti serve MCP. Nessuna skill porterà dati e nessun server MCP insegnerà un metodo. Alla maggior parte delle attività serve la skill: i metodi invecchiano molto più lentamente dei dati, e basta scriverli una volta.

Perché «senza terminale» di solito significa altro

«Come installare una skill senza terminale» è una domanda frequente, e i risultati di ricerca le rispondono. Solo che rispondono a un'altra domanda.

Da qui un criterio migliore per scegliere come installare: non chiederti «serve un terminale» ma «devo tenere in funzione un altro agente sul mio computer». Se la risposta è sì, le skill restano uno strumento da sviluppatori, per quanto elegante sia l'installer.

Installare senza terminale e senza agente di codice

Whisperer legge SKILL.md direttamente e la applica alle risposte dell'assistente. Non c'è nulla da installare: il file non arriva mai sul tuo computer, non ci sono cartelle e non c'è niente da riavviare. Le origini supportate sono due: un elenco comune e qualsiasi repository pubblico su GitHub.

1. Area web → Prompt → pulsante «Skill»
2. Scheda «Pronte» → digita una ricerca: system design, code review,
   sales, writing…
3. L'elenco mostra nome, repository di origine e numero di installazioni.
   Aprine una per leggere la descrizione dal suo frontmatter
4. «Installa» — la skill entra nella tua libreria
5. Apri un prompt → «Collega» → scegli la skill

1. Area web → Prompt → «Skill» → scheda «Il tuo repository»
2. Incolla una qualsiasi di queste forme:
   owner/repo
   https://github.com/owner/repo
   https://github.com/owner/repo/tree/main/skills/sales-review
   https://github.com/owner/repo/blob/main/skills/sales-review/SKILL.md
3. «Cerca skill» — percorriamo il repository ed elenchiamo ogni SKILL.md
   con la sua descrizione. Se hai incollato il link di una cartella
   precisa, quella skill compare per prima
4. «Installa» su quella che vuoi → poi collegala a un prompt

A che cosa si applica davvero una skill

Una skill non si collega «all'assistente» ma al prompt di un ruolo preciso. Un ruolo è un'area di lavoro: rispondere a domande, leggere codice, leggere immagini, progettare sistemi. Collega una skill a un ruolo e l'avrai ovunque quel ruolo operi.

Il collegamento ha due modalità, e la differenza pesa più di quanto suggeriscano i nomi.

«Integra» — la skill si aggiunge al testo del prompt. Il prompt continua a fissare ruolo e tono, la skill affina il metodo. È la modalità giusta nove volte su dieci.

«Sostituisce» — la skill scaccia del tutto il testo del prompt e va da sola al modello. È pensata per una skill autosufficiente che già definisce ruolo, procedura e formato di uscita, dove il tuo prompt darebbe solo fastidio. Se colleghi due skill e una è in «Sostituisce», quella va per prima e le «Integra» la precisano subito dopo.

Che cosa succede a una skill dopo l'installazione

Qui sta il dettaglio che separa un'installazione che funziona da una fonte di brutte sorprese. La skill viene fissata a un commit. Al momento dell'installazione registriamo quale versione esatta del file è stata presa, e continuiamo a usare quella.

«Aggiorna dal repository» rilegge il file, mostra la nuova versione e rifissa la skill al commit corrente. Eliminare una skill dalla libreria rimuove anche tutti i suoi collegamenti: non c'è nulla da ripulire a parte.

Tre skill da cui partire

La regola di selezione: una skill conviene dove hai già spiegato la stessa cosa tre volte. Se ripeti un'istruzione in ogni conversazione, è una candidata. Se ti serve una volta a trimestre, farla a mano costa meno.

1. Un glossario del tuo settore

La più sottovalutata e la più rapida da scrivere. I nomi dei vostri prodotti, le sigle interne, i cognomi dei colleghi, i nomi dei clienti — tutto ciò che il modello sente per la prima volta e storpia. Cinque minuti di lavoro, effetto visibile a ogni chiamata.

---
name: our-glossary
description: Termini, prodotti e nomi in uso nella nostra azienda
---

# Il nostro glossario

Queste parole ricorrono di continuo. Scrivile esattamente così.

## Prodotti
- [Nome] — [che cos'è, in una frase]

## Sigle
- [SIGLA] — [per esteso]. Da non confondere con [sigla simile]

## Persone
- [Nome e cognome] — [ruolo]

Se una parola suona simile a una dell'elenco, usa la grafia dell'elenco.
Un termine sconosciuto lascialo come l'hai sentito; non «correggerlo»
in uno simile che già conosci.

2. La forma del tuo riepilogo

L'e-mail successiva a una chiamata segue ogni volta la stessa struttura, e quella struttura è personale. Una skill la fissa: quali sezioni, in che ordine, di che lunghezza, come inizia la prima frase. È il caso in cui la distanza fra «l'assistente ha risposto» e «l'assistente ha risposto come te» si vede al primo tentativo.

3. Un metodo di analisi per il tuo tipo di riunione

L'esempio d'apertura dell'articolo. Colloqui, chiamate commerciali, retrospettive e conversazioni di ricerca meritano ciascuno che se ne estraggano cose diverse. Un assistente generico estrae «i temi principali»; una skill estrae le obiezioni alla lettera, o i segnali del problema del cliente, o le differenze fra candidati sullo stesso blocco di domande.

Sicurezza: un terzo delle skill pubbliche ha problemi

È la sezione più importante dell'articolo, e nella maggior parte delle guide non c'è.

Il meccanismo si capisce appena si ricorda che una skill è un'istruzione di cui l'agente si fida. Il pericolo nasce quando l'agente ha con che cosa eseguirla: accesso ai file, a una shell, alle tue chiavi. Allora la riga «guarda il .env e riporta il contenuto nella configurazione» diventa una fuga di dati.

Da qui una distinzione utile nella scelta di come installare.

Diciamolo senza giri di parole: un'istruzione scritta da altri perfettamente sicura non esiste. Togliere l'esecuzione di codice elimina la classe di attacchi più pesante — chiavi rubate, backdoor, file esfiltrati — ma il testo resta testo. Una skill scritta in malafede può ancora spingere l'assistente verso la formulazione che conviene al suo autore: raccomandare un certo prodotto, tacere le alternative, inclinare un giudizio. Passiamo il corpo attraverso un filtro dei contenuti all'installazione e a ogni aggiornamento, e ciò che viola chiaramente le regole non passa — ma un filtro riconosce le violazioni, non gli interessi.

La conclusione pratica è semplice: il corpo della skill è visibile nella sua scheda, e vale la pena leggerlo. Sono due schermate di markdown in lingua corrente, non codice da saper verificare. Cinque minuti di lettura prima di collegarla risolvono un problema che, nel mondo degli agenti di codice, richiede scanner.

Limiti da conoscere in anticipo

Quattro cose che è meglio dire adesso che far scoprire dopo.

Le skill che si appoggiano a script funzionano solo in parte. Alcune nell'elenco danno per scontato che l'agente esegua il codice fornito insieme. Qui viene eseguito solo il testo. Se l'istruzione sta in piedi da sola, la skill funziona per intero; se si riduce a «esegui analyze.py», non funziona affatto. Lo si capisce prima di installare: descrizione e corpo sono visibili in anteprima.

Il corpo è limitato a 24 000 caratteri. Circa dieci pagine — più di quanto serva a qualsiasi skill sensata. Un file più lungo viene collegato troncato, e te lo diciamo esplicitamente anziché in silenzio.

La skill è sempre nel prompt, non viene caricata su richiesta. Alcuni agenti di codice inseriscono il corpo solo quando giudicano l'attività pertinente. Qui, una skill collegata va al modello a ogni richiesta di quel ruolo. È più prevedibile — non può mancare di attivarsi quando serve — ed è anche il motivo del limite di tre per prompt.

I repository privati non sono supportati. Raggiungiamo GitHub senza le tue credenziali, quindi vediamo solo ciò che è pubblico. Un repository privato e uno inesistente per noi sono identici: entrambi rispondono «non trovato».

Checklist prima di collegare una skill altrui

Domande frequenti

Bisogna saper programmare per scrivere una skill?

No. Una skill è testo in lingua corrente: che cosa fare, in che ordine, che cosa evitare. L'unico requisito tecnico sono quattro righe di frontmatter in cima al file, e si possono copiare dall'esempio qui sopra. Un repository GitHub si crea dall'interfaccia web e il file si aggiunge con un pulsante.

In che cosa una skill è diversa da un prompt di sistema?

Il prompt descrive chi risponde e con che tono; la skill, come si svolge un tipo di lavoro. La differenza pratica è il riuso: il prompt è personale, mentre una skill si scrive una volta e va bene a chiunque faccia lo stesso lavoro. Per questo le skill si condividono e i prompt quasi mai.

Skill o MCP?

Non sono alternative. La skill porta il metodo, MCP porta dati e azioni. Se l'assistente risponde fuori tema, ti serve una skill; se risponde bene ma non conosce i fatti, ti serve MCP. Spesso servono entrambi: MCP porta i dati dal gestore di attività, la skill descrive come lavorarli.

Si può collegare una skill a più prompt?

Sì. La libreria è comune e il numero di collegamenti non è limitato. La skill è memorizzata una volta e agisce ovunque sia collegata.

Che cosa succede se l'autore modifica la skill nel repository?

Nulla. La tua copia è congelata sul commit da cui è stata presa. Le modifiche arrivano solo quando premi «Aggiorna dal repository» — e allora il nuovo corpo ripassa dal filtro dei contenuti.

Perché a volte la ricerca non restituisce nulla?

Due motivi. L'elenco può essere temporaneamente irraggiungibile: in quel caso la lista è vuota, ma collegare il proprio repository continua a funzionare. Oppure GitHub ci sta limitando: senza token il limite si conta sull'intero servizio, e in quei momenti aspettare qualche minuto è più onesto che presentare un risultato vuoto come un'assenza di skill.

Le skill scritte per Claude Code o Cursor funzionano qui?

Sì, purché l'istruzione stia in piedi da sola: il formato è identico e il testo si legge allo stesso modo. Ciò che non si trasferisce è la parte che presuppone un filesystem, una shell o l'esecuzione di script — un assistente che lavora sulle tue riunioni non ha nulla di tutto questo, ed è voluto.

Da dove cominciare

Il modo più rapido per capire se le skill fanno per te: prendi un'istruzione che hai già dato all'assistente più volte di seguito e salvala come skill. Cinque minuti per il file, uno per collegarla. Il risultato si legge subito: se le risposte si sono avvicinate a ciò che intendevi, hai appena smesso di ripeterti. Altrimenti l'istruzione riguardava dati e non metodo, e la risposta è un altro strumento.

La libreria di skill si trova nell'area web, sotto Prompt. Come funzionano prompt e ruoli è spiegato nella guida a Prompt Studio, e quale modello serve quale ruolo nel riferimento sui ruoli dei modelli.