In GitHub Copilot, Agents, Instructions e Skills sono i “mattoni” che compongono l’ecosistema di personalizzazione dell’IA. Anche se possono sembrare simili, servono a scopi diversi e operano con gradi di autonomia differenti.
Ecco una guida per distinguerli chiaramente:
1. Instructions (Le Regole)
Le Custom Instructions sono linee guida statiche che definiscono come Copilot deve comportarsi e quali standard deve seguire. Sono il “background” sempre attivo.
- Cosa sono: Semplici file di testo (es.
.github/copilot-instructions.md) che Copilot legge prima di ogni risposta. - A cosa servono: Impostare standard di codifica (es. “usa sempre le arrow functions”), preferenze di linguaggio, o regole di accessibilità.
- Quando usarle: Quando vuoi che Copilot rispetti sempre certe convenzioni senza doverglielo ricordare ogni volta.
- Trigger: Automatico. Vengono applicate a ogni prompt nel repository.
2. Skills (Le Competenze)
Le Agent Skills sono pacchetti di capacità specifiche e ripetibili. Se le Instructions sono “regole di comportamento”, le Skills sono “manuali operativi”.
- Cosa sono: Cartelle contenenti un file
SKILL.md(con istruzioni dettagliate) ed eventualmente script, template o risorse. Seguono uno standard aperto (usato anche da modelli come Claude). - A cosa servono: Eseguire task complessi in modo deterministico (es. “genera uno schema di database”, “crea un test di integrazione per il login”).
- Quando usarle: Quando hai un compito che deve essere eseguito sempre nello stesso modo, con risorse specifiche (come template predefiniti).
- Trigger: Possono essere richiamate manualmente (es. scrivendo
/nome-skillin chat) o caricate automaticamente da un Agent quando il compito lo richiede.
3. Agents (Gli Esperti)
Un Agent è una “persona digitale” o un assistente specializzato che possiede autonomia di ragionamento. È il livello più alto della piramide.
- Cosa sono: Persona definite da un file di configurazione (es.
AGENT.md) che possono combinare istruzioni specifiche, strumenti (tools) e skills. - A cosa servono: Risolvere problemi aperti o multi-step (es. un
@code-reviewerche analizza tutto il file o un@test-writerche decide quali test scrivere). - Quando usarli: Quando il compito richiede giudizio, pianificazione o l’uso di strumenti esterni (tramite protocollo MCP).
- Trigger: Si attivano menzionandoli con la chiocciola (es.
@workspace,@terminalo agenti personalizzati).
Tabella Comparativa
| Caratteristica | Instructions | Skills | Agents |
| Natura | Regole e standard | Task ripetitivi e “manuali” | Persona esperta e autonoma |
| Contenuto | Solo testo (Markdown) | Testo + Script + Template | Istruzioni + Strumenti + Skills |
| Filosofia | “Segui queste regole” | “Esegui questo compito così” | “Risolvi questo problema” |
| Attivazione | Sempre attiva (implicita) | On-demand o contestuale | Esplicita (tramite @) |
| Portabilità | Specifica di Copilot | Standard aperto (multi-piattaforma) | Spesso legata all’ecosistema |
In sintesi:
Immagina di costruire una casa:
- Le Instructions sono il regolamento edilizio (le regole da non infrangere).
- Le Skills sono gli attrezzi e i kit di montaggio (come montare una porta).
- L’Agent è l’architetto o il capocantiere a cui affidi il progetto e che decide quali attrezzi usare.