Cos'è una skill per agenti AI
Una skill è un pacchetto di competenza procedurale: insegna a un agente come svolgere un compito specifico, nel modo in cui lo svolgerebbe un esperto del tuo team.
La definizione
Una skill è una cartella che contiene un file SKILL.md e, se servono, altre risorse: documenti di riferimento, modelli, script. Il file SKILL.md inizia con un'intestazione in YAML (almeno name e description) seguita da istruzioni in Markdown.
verifica-fattura-elettronica/
├── SKILL.md
├── scripts/
│ └── valida.py
└── references/
└── codici-natura.mdCome la usa l'agente: caricamento progressivo
Il formato è pensato per non riempire la memoria di lavoro dell'agente:
- Scoperta: all'avvio l'agente legge solo nome e descrizione di ogni skill disponibile, poche decine di parole ciascuna.
- Attivazione: quando un compito corrisponde alla descrizione, l'agente carica le istruzioni complete del SKILL.md.
- Risorse: script, riferimenti e modelli vengono letti o eseguiti solo quando le istruzioni lo richiedono.
Per questo un agente può avere a disposizione decine di skill senza diventare più lento o confuso: carica solo quella che serve.
Da dove viene il formato
Il formato SKILL.md è nato in ambito Anthropic per gli agenti Claude ed è stato pubblicato come standard aperto (Agent Skills) alla fine del 2025. Da allora è stato adottato da diversi agenti e strumenti di sviluppo. AgentSkillSharing è un progetto indipendente e non è affiliato agli autori del formato.
Perché funziona meglio di un prompt lungo
- Riutilizzabile: si scrive una volta, si usa in ogni conversazione e da ogni persona del team.
- Versionabile: è una cartella di file, si gestisce come il codice.
- Affidabile: le operazioni delicate si affidano a script testati invece che all'improvvisazione del modello.
- Leggera: grazie al caricamento progressivo non occupa contesto finché non serve.
I limiti
- Una skill con script esegue codice: va letta e verificata come qualsiasi software di terzi.
- La qualità dipende dalla descrizione: se è vaga, l'agente non la attiva al momento giusto.
- Non collega l'agente a sistemi esterni da sola: per quello servono strumenti o connettori, ad esempio server MCP.
Domande frequenti
Che differenza c'è tra una skill e un plugin?
Un plugin aggiunge di solito funzioni o connessioni a un'applicazione. Una skill aggiunge soprattutto competenza: istruzioni e procedure, eventualmente con script di supporto, che l'agente legge e applica.
Una skill funziona su qualsiasi modello AI?
Il formato è testo e file, quindi è portabile. Serve però un agente che sappia scoprire e caricare le skill; gli script richiedono inoltre un ambiente in cui eseguirli.
Quanto deve essere lungo un SKILL.md?
Il più breve possibile: la specifica raccomanda di restare sotto le 500 righe e di spostare i dettagli nei file di riferimento.
Iscriviti all'accesso anticipato
Iscrizione gratuita. Ti scriviamo quando si apre il tuo posto nella beta e quando definiamo le condizioni per sviluppatori e team. Niente newsletter promozionali.
- Gratuito durante l'accesso anticipato
- Puoi già proporre le tue skill
- Ti cancelli con un clic