Cosa sono le skill degli agenti? Esempi e guida introduttiva

Le skill degli agenti sono pacchetti riutilizzabili di istruzioni e, facoltativamente, script, riferimenti e modelli che guidano un agente IA nello svolgimento di un'attività specifica. Nel formato aperto Agent Skills, ogni pacchetto è una cartella incentrata su un file SKILL.md. Gli agenti compatibili possono individuare le skill e caricarne le istruzioni quando sono pertinenti, invece di mantenere tutte le procedure contemporaneamente nella conversazione. Questa guida illustra il formato, mostra esempi pratici e spiega come creare e testare la tua prima skill.

Agent Skills è un formato aperto e leggero per creare pacchetti di conoscenze e flussi di lavoro specializzati. Una skill contiene un file SKILL.md con frontmatter YAML che ne descrive il nome e lo scopo, seguito da istruzioni in Markdown. I file di supporto possono includere script, documenti di riferimento e modelli.

Il termine “skill di IA” può riferirsi a diverse cose, tra cui la capacità delle persone di usare l'IA. In questa guida, le skill degli agenti e le skill degli agenti IA si riferiscono specificamente a pacchetti SKILL.md riutilizzabili per agenti compatibili.

Ad esempio, una skill per il riepilogo delle riunioni può definire le sezioni del verbale di un team, come registrare le decisioni e come segnalare responsabili o scadenze mancanti. Salvi queste regole una volta e le riutilizzi con le note delle nuove riunioni. La skill guida il lavoro dell'agent; non riaddestra il modello sottostante.

La specifica aperta richiede nome e descrizione nel frontmatter. Il nome deve avere da 1 a 64 caratteri, usare lettere minuscole, cifre e trattini, e corrispondere al nome della directory; non può iniziare o terminare con un trattino né contenere trattini consecutivi. La descrizione deve avere da 1 a 1.024 caratteri e spiegare sia l'attività sia quando usare la skill.

Il formato è progettato per la divulgazione progressiva: gli agenti ricevono informazioni sufficienti per selezionare una skill prima di caricarne le istruzioni complete.

1. Individuazione. L'agent riceve i nomi e le descrizioni delle skill disponibili. Questi metadati usano comunque contesto, ma le procedure complete non vengono tutte caricate in anticipo.

2. Attivazione. Quando l'agent seleziona una skill pertinente, legge SKILL.md. Alcuni strumenti consentono anche di richiamare una skill per nome o di disattivare la selezione automatica.

3. Esecuzione. L'agent segue la procedura e, quando necessario e consentito, legge i riferimenti di supporto o esegue gli script.

Questo riduce il contesto usato dalle procedure inattive. L'uso effettivo del contesto dipende dal numero e dalla lunghezza delle descrizioni, dalle skill attive e dalle eventuali risorse caricate. Descrizioni chiare aiutano la selezione, ma l'attivazione e la qualità dell'output richiedono comunque test.

Il vocabolario degli strumenti di IA è affollato e il termine "skill" si affianca a diversi concetti simili. Ecco le differenze:

Skill e prompt. Un prompt fornisce istruzioni in una conversazione; una skill memorizza una procedura riutilizzabile e risorse di supporto per l'individuazione o il richiamo esplicito. Anche i prompt possono essere salvati e riutilizzati. Una skill è utile quando un'attività ricorrente richiede un flusso di lavoro gestito, esempi, riferimenti o script.

Skill e MCP. MCP fornisce a un agent capacità operative, ovvero connessioni a strumenti e dati in tempo reale. Una skill fornisce a un agent conoscenze: come svolgere bene un'attività, in quale sequenza e con quali passaggi di verifica. I due elementi si completano a vicenda. Una skill per la revisione del codice definisce cosa costituisce una revisione approfondita, mentre un server GitHub MCP consente all'agent di leggere la pull request effettiva.

Skill e istruzioni di progetto. File come AGENTS.md forniscono indicazioni per il progetto secondo le regole di caricamento e ambito dell'agent. Mantieni lì le convenzioni di applicazione generale e usa le skill per procedure specifiche per attività, da caricare quando pertinenti. Il comportamento esatto dipende dallo strumento.

• Competenze riutilizzabili: acquisisci metodi, checklist e modelli specifici per attività, così non devi spiegarli ogni volta.

• Procedure più coerenti: fornisci agli agenti gli stessi passaggi e criteri di revisione per attività ricorrenti. I risultati richiedono comunque una verifica.

• Efficienza del contesto: carica istruzioni dettagliate quando servono, anziché inserire ogni procedura nelle indicazioni caricate sempre.

• Riutilizzo tra strumenti: condividi il formato base SKILL.md tra agenti compatibili, verificando prima dell'uso l'accesso agli strumenti, le dipendenze e i campi specifici della piattaforma.

• Manutenzione del team: conserva le cartelle delle skill nel controllo di versione, in modo da poter revisionare le modifiche a un flusso di lavoro condiviso.

Le skill degli agenti sono supportate da una gamma crescente di strumenti di IA, tra cui Claude Code, OpenAI Codex, Cursor, GitHub Copilot e Kimi Code. Questi strumenti usano pacchetti di skill riutilizzabili per fornire agli agenti istruzioni, flussi di lavoro e risorse di supporto specifici per attività.

Il formato condiviso SKILL.md facilita il riutilizzo delle skill tra strumenti compatibili, anche se i percorsi di installazione e i metodi di richiamo variano a seconda del prodotto. Se una skill si basa su script o strumenti esterni, verifica che tali dipendenze siano disponibili nell'ambiente in cui intendi usarla.

Una skill utile raccoglie le regole che rendono un'attività ricorrente specifica per il tuo team. Questi esempi mostrano cosa includere in un pacchetto e cosa verificare nel risultato:

Anche l'elaborazione di documenti e l'analisi ricorrente dei dati sono buoni candidati, ma spesso richiedono strumenti o script che vanno oltre SKILL.md. Inizia con un flusso di lavoro circoscritto, verifica gli output e aggiungi dipendenze solo quando l'attività le richiede.

Scegli l'ambiente più adatto al tuo compito. I metodi di creazione descritti sopra includono la creazione in linguaggio naturale e un flusso di lavoro locale basato su file.

Kimi Code CLI individua le skill nelle directory di progetto .agents/skills/ e .kimi-code/skills/ e nelle directory utente ~/.agents/skills/ e ~/.kimi-code/skills/. La directory utente specifica di Kimi può cambiare con KIMI_CODE_HOME. Richiama una skill con /skill:<name> oppure lascia che il modello la selezioni in base alla descrizione e ai campi di attivazione supportati. La selezione automatica può essere disattivata per singole skill. Quando configuri percorsi o campi specifici della piattaforma, consulta la documentazione CLI aggiornata.

Non è necessario configurare tutto da zero. Apri Kimi su desktop o sul web, esplora lo Skill Store e installa una Skill con un clic per iniziare a usarla in Kimi. Dalla ricerca e scrittura alla programmazione e all'analisi dei dati, il Kimi Skill Store offre skill per un'ampia gamma di attività. Esplora lo store nell'app desktop o web di Kimi, installa una Skill con un clic e inizia a usarla in Kimi.

Puoi creare una skill descrivendo un flusso di lavoro a uno strumento di IA oppure scrivendo personalmente SKILL.md. Inizia con un'attività ripetuta e un risultato facile da verificare, come un verbale di riunione.

In Kimi, apri il pannello Skills per scoprire o installare skill. Per crearne una personalizzata, carica una procedura o descrivi ciò che desideri in una conversazione dedicata alla creazione di skill. Puoi anche usare /skill-creator. Consulta la guida alle Skills di Kimi per i punti di accesso aggiornati.

Passaggio 1: apri lo store Skills di Kimi e fai clic su "customize" > "Create with Kimi".

Passaggio 2: descrivi la skill che ti serve.

Indica a Kimi l'attività, l'input previsto, la struttura dell'output e le regole per le informazioni mancanti.

Ad esempio:

Se nel risultato manca una regola, chiedi a Kimi di correggerla e ripeti il test. Per una SOP esistente, specifica quali parti sono istruzioni e quali materiale di contesto; rimuovi i contenuti irrilevanti o sensibili prima di inserirla nel pacchetto. Una volta creata, puoi usare subito la skill con Kimi.

Questo esempio usa solo istruzioni testuali e non richiede script aggiuntivi. Usa Kimi Code CLI per dimostrare l'installazione e il richiamo; altri agent potrebbero usare percorsi e comandi diversi.

Passaggio 1: crea la cartella. Per una skill a livello utente in Kimi Code CLI, crea ~/.agents/skills/meeting-summary/. Per una skill a livello di repository condivisa con un team, usa invece .agents/skills/meeting-summary/ nella radice del repository.

Passaggio 2: salva SKILL.md. Crea ~/.agents/skills/meeting-summary/SKILL.md e incolla il testo seguente. La descrizione identifica l'attività; il corpo definisce l'output e le regole per le informazioni mancanti.

Passaggio 3: avvia una nuova sessione e richiamala. Dopo aver salvato il file, avvia una nuova sessione di Kimi Code CLI. Inserisci questo comando nell'input della chat:

Passaggio 4: verifica il risultato. Quello che segue è un output previsto a scopo illustrativo, non l'esecuzione registrata di un prodotto. La formulazione può variare; le sezioni, la decisione, i responsabili e le scadenze devono seguire la skill.

Passaggio 5: testa la selezione automatica e i limiti. In una nuova conversazione, chiedi “Trasforma questi appunti della riunione in un verbale” senza il comando con barra e fornisci gli stessi appunti. Verifica, dove disponibile, se l'agent carica la skill tramite il registro delle attività dell'interfaccia e se l'output segue le sue regole. Poi prova una richiesta non correlata, come “Spiega la ricorsione in Python”; la skill meeting-summary dovrebbe rimanere inattiva. Richiamala anche senza appunti: dovrebbe chiedere l'input.

Per script, riferimenti lunghi o modelli, aggiungi scripts/, references/ o assets/ secondo necessità e collegali da SKILL.md. Consulta la documentazione delle Skills di Kimi Code CLI per i percorsi aggiornati e le opzioni di richiamo.

• Definisci un'attivazione chiara: spiega sia l'attività sia quando usare la skill. Includi i termini che gli utenti usano naturalmente e testa richieste pertinenti e non pertinenti.

• Mantieni le istruzioni mirate: la specifica raccomanda meno di 500 righe e meno di 5.000 token per il file principale. Sono indicazioni distinte, non una conversione da righe a token. Sposta i riferimenti dettagliati in file di supporto.

• Specifica output verificabili: includi le sezioni richieste, esempi di input e output e regole per le informazioni mancanti.

• Documenta le dipendenze: identifica gli strumenti e i pacchetti necessari e usa metadati di compatibilità quando opportuno. Mantieni separate dal nucleo portabile le estensioni specifiche della piattaforma.

• Controlla le azioni con conseguenze: usa un richiamo esplicito e regole di approvazione adeguate per i flussi di lavoro che inviano messaggi o distribuiscono modifiche. Il solo richiamo manuale non sostituisce i controlli delle autorizzazioni.

• Esamina i pacchetti di terze parti: prima dell'installazione, controlla le istruzioni e gli script inclusi, compresi i dati e le autorizzazioni che utilizzano.

Le skill degli agent trasformano le attività ripetute in flussi di lavoro riutilizzabili che gli agenti IA compatibili possono caricare quando necessario. Inizia con un SKILL.md mirato che definisca quando usare la skill e quale output deve produrre. Aggiungi script o riferimenti solo quando l'attività lo richiede, quindi verifica quando la skill si attiva e la qualità del suo output.