# Agent Skills: impacchettare il know-how per gli assistenti AI
Table of Contents
Gli assistenti basati sull’intelligenza artificiale sono bravi a rispondere a domande e a scrivere testi. Quando però devono seguire una procedura precisa - il modo in cui una certa azienda prepara un report, applica una convenzione sui nomi dei file o compila un modulo - vanno guidati ogni volta. Di solito si finisce per reincollare le stesse istruzioni in ogni conversazione, oppure per costruire un assistente su misura per ciascun compito. Il 16 ottobre 2025 Anthropic, l’azienda che sviluppa l’assistente Claude, ha presentato le Agent Skills: un modo per impacchettare quelle istruzioni, e gli eventuali script, in cartelle riutilizzabili che l’assistente carica solo quando servono.
Dietro il nome tecnico c’è un’idea semplice, che riguarda chiunque usi l’AI per compiti che si ripetono. Vale la pena capirla.
Prima, un chiarimento sui termini
Qui per agente si intende un assistente AI che non si limita a rispondere, ma può usare strumenti e compiere più passi per portare a termine un’attività: leggere un file, eseguire un piccolo programma, produrre un documento. Un altro termine utile è contesto: è tutto ciò che l’assistente “ha davanti” mentre lavora, cioè la richiesta dell’utente più le istruzioni e le informazioni caricate in quel momento. Il contesto ha uno spazio limitato: più roba ci si mette, più diventa dispersivo e costoso. Tenere a mente questo limite aiuta a capire perché le Skills sono fatte come sono.
Il problema: ogni procedura riscritta da capo
Un’azienda accumula col tempo un patrimonio di “come si fa qui”: il formato standard di una fattura, i passaggi per generare un bilancio mensile, le regole di stile per un testo, la sequenza esatta per preparare un pacchetto software. Sono conoscenze procedurali, spesso non scritte da nessuna parte in modo ordinato.
Per far seguire una di queste procedure a un assistente AI ci sono due strade, entrambe scomode. La prima è incollare le istruzioni nella conversazione ogni volta: funziona, ma è ripetitivo e facile da sbagliare, e occupa spazio prezioso nel contesto. La seconda è costruire un assistente dedicato per ogni singolo compito: preciso, ma richiede lavoro tecnico e va rifatto per ognuna delle tante procedure. In entrambi i casi il know-how resta difficile da riutilizzare e da condividere.
Le Agent Skills nascono per togliere di mezzo proprio questa frizione: scrivere una procedura una volta, in un formato ordinato, e poterla poi richiamare quando serve senza reincollarla.
Cos’è una Skill: una cartella con dentro le istruzioni
Nella pratica una Skill è semplicemente una cartella. Dentro c’è un file obbligatorio chiamato SKILL.md e, se servono, altri file: documenti di approfondimento, esempi, oppure piccoli script pronti all’uso.
Il file SKILL.md è scritto in un formato leggibile anche da una persona. In cima ha poche righe di metadati in YAML - un modo essenziale per annotare coppie “etichetta: valore” - con almeno un nome e una descrizione di cosa fa la Skill. Sotto, in Markdown (lo stesso testo semplice di tanti file di appunti), ci sono le istruzioni vere e proprie: i passaggi da seguire, le convenzioni da rispettare, gli esempi. In sostanza è un foglio di istruzioni ordinato. Anthropic usa un’analogia efficace: costruire una Skill è come preparare la guida di benvenuto per una persona appena assunta.
Una struttura minima somiglia a questa:
report-mensile/ SKILL.md # cosa fa e come si fa, passo per passo esempio.md # un caso già svolto, come riferimento genera.py # uno script opzionale per i passaggi ripetitiviIl fatto che sia una cartella con file di testo ha un vantaggio pratico non piccolo: una Skill si può salvare, versionare come si fa con il codice, e passare a un collega semplicemente condividendo la cartella.
Il trucco: caricare le informazioni a strati
Se ogni Skill venisse caricata per intero e sempre, si tornerebbe al problema del contesto ingombro. Le Agent Skills evitano questo con un caricamento progressivo, cioè a strati, per mettere davanti all’assistente solo ciò che serve al momento.
Funziona così, in tre livelli:
- All’avvio l’assistente conosce soltanto nome e descrizione di ogni Skill disponibile. Poche righe a testa: giusto abbastanza per sapere che quella Skill esiste e a cosa serve.
- Quando la richiesta dell’utente combacia con una Skill, l’assistente apre e legge il contenuto completo del relativo
SKILL.md, con tutte le istruzioni. - Se il
SKILL.mdrimanda ad altri file - un documento di dettaglio, un esempio lungo - quelli vengono aperti solo se davvero necessari.
Il risultato è che si possono tenere a disposizione molte Skills, anche corpose, senza appesantire ogni conversazione. L’assistente “sfoglia l’indice” e va a leggere il capitolo giusto solo quando gli serve, invece di tenere tutti i manuali aperti sulla scrivania.
C’è un secondo elemento utile: una Skill può includere script già scritti, per esempio in Python. Per i passaggi ripetitivi e meccanici, l’assistente può eseguire quel codice invece di improvvisare la procedura ogni volta, un po’ come si affida a un timer automatico un compito che altrimenti andrebbe rilanciato a mano. Per certi compiti è più affidabile e più economico far girare uno script collaudato che chiedere al modello di rifare tutto a mano.
Dove si possono usare
Le Agent Skills funzionano nello stesso formato in più contesti: l’app di Claude (per i piani Pro, Max, Team ed Enterprise), lo strumento per sviluppatori Claude Code, l’API rivolta agli sviluppatori e l’Agent SDK, cioè il kit per costruire i propri agenti. Lo stesso pacchetto, quindi, si sposta da un ambiente all’altro senza doverlo riscrivere.
Al lancio Anthropic ha messo a disposizione alcune Skills pronte per compiti d’ufficio molto comuni: creare fogli di calcolo Excel con le formule, presentazioni PowerPoint, documenti Word e moduli PDF compilabili. C’è poi una Skill particolare, la skill-creator, che aiuta a costruirne di nuove in modo guidato: fa domande sul flusso di lavoro, prepara la struttura di cartelle e imposta il file SKILL.md. Un modo per iniziare senza partire dal foglio bianco.
Sul piano della disponibilità, va detto per correttezza che non tutto è identico ovunque: l’uso via API, per esempio, si appoggia alla funzione di esecuzione del codice, ancora in fase beta, e negli account aziendali un amministratore deve abilitare la funzione per l’organizzazione. Dettagli, ma utili per non farsi trovare impreparati.
Perché è utile a chi ha procedure ricorrenti
Il valore vero non sta in una singola funzione, ma nello spostamento di lavoro che rende possibile. Una procedura scritta bene una volta smette di essere un’istruzione da ripetere a voce e diventa un pezzo riutilizzabile: si richiama quando serve, si può migliorare nel tempo modificando un file, si passa a un collega condividendo una cartella. In pratica è un modo per capitalizzare il know-how che oggi vive nella testa delle persone o sparso in appunti diversi.
Per chi gestisce sistemi e infrastrutture il paragone è immediato: è la stessa logica per cui una procedura ripetitiva conviene metterla in uno script o in un playbook, invece di eseguirla a memoria ogni volta. Qui il “playbook” è scritto in modo che possa seguirlo un assistente AI, con la possibilità di includere anche il codice per i passaggi meccanici.
Attenzione alla provenienza
Una nota di prudenza, che Anthropic stessa mette in evidenza. Una Skill può contenere istruzioni e codice che vengono eseguiti, e può indicare all’assistente di accedere a risorse esterne. Vanno quindi installate solo da fonti di cui ci si fida, e quelle di provenienza incerta è bene esaminarle prima: cosa contengono i file, se il codice si collega a servizi esterni, se ci sono istruzioni che potrebbero portare dati fuori dove non dovrebbero. È la stessa cautela che si userebbe prima di far girare uno script scaricato da internet. La comodità non toglie la responsabilità di controllare.
In sintesi
Le Agent Skills, presentate da Anthropic il 16 ottobre 2025, sono cartelle che raccolgono istruzioni e script riutilizzabili per gli assistenti AI, con al centro un file SKILL.md in testo semplice. Risolvono un problema concreto e quotidiano: non dover riscrivere ogni volta le stesse procedure. Il caricamento a strati permette di tenerne a disposizione molte senza ingombrare il contesto, e la possibilità di includere script rende più affidabili i passaggi ripetitivi. Funzionano nell’app, in Claude Code, via API e con l’Agent SDK. Quanto diventerà uno strumento diffuso lo diranno i mesi a venire; l’idea di fondo, però, è chiara e sensata: mettere il know-how in un formato ordinato e riutilizzabile, invece di ripeterlo a voce ogni volta.
