Come usare le Agent Skills

Le Agent Skills sono uno dei modi più efficaci per usare gli LLM. Offrono il contesto giusto per il compito che vuoi svolgere, in modo ripetibile.

E la parte migliore?

Le aziende scrivono queste skill per te, quindi tutto quello che devi fare è usarle nei tuoi workflow. In questa guida ti mostro come sfruttare queste skill per scrivere funzionalitàche funzionano davvero.

Cosa sono le Skills?

Una “Skill” è una cartella con file markdown che spiegano come svolgere un compito specifico. Il file principale della skill deve chiamarsiSKILL.md, e il contenuto di questo file può essere quello che vuoi, purché il frontmatter contenga i campi name e description. (Ci sono altricampi opzionali nel frontmatter che puoi trovare qui.)

Si consiglia che questo file principaleSKILL.mdsia inferiore a 500 righe.

All’interno di questa cartella puoi inserire altre informazioni, che possono essere richiamate dal fileSKILL.md, ma vengono caricate nel contesto solo quando serve. Queste informazioni dovrebbero essere salvate nelle seguenti cartelle:

1. scripts/ - Codice eseguibile che gli agent possono eseguire.
2. references/ - Altri file markdown che possono servire come documentazione aggiuntiva, quando necessario.
3. assets/ - Risorse statiche che l’agent può usare.

Cosa rende speciali le Skills?

Uno dei problemi principali nell’uso dell’IA è ilContext Bloat.Il context bloat si verifica quando fornisci all’IA così tanto contesto (cioè informazioni) che fa fatica a portare a termine il compito.

Immagina di dare a uno sviluppatore junior la documentazione esatta per una funzionalità specifica e nient’altro di irrilevante. Dopo aver letto questa documentazione, avrebbe molte probabilità di riuscire a implementarla.

Ora immagina di chiedere allo sviluppatore junior di leggere TUTTA la documentazione. Poi, dopo averla letta, di implementare una funzionalità specifica che riguarda solo una piccola parte della documentazione. Le probabilità di successo sarebbero molto più basse.

Gli LLM si comportano allo stesso modo.

Approcci precedenti, come MCP, hanno provato a risolvere il problema caricando grandi quantità di contesto strutturato nel modello. Questo funzionava meglio che non avere contesto, ma comunque faticava a portare a termine i compiti in modo costante.

Le Skills sono diverse.

Per impostazione predefinita, solo il nome e la descrizione dal frontmatter vengono caricati nella finestra di contesto. Questo occupa pochissimo spazio, ma dà all’LLM informazioni su quali skill sono disponibili. Quando si decide che una Skill è utile, il fileSKILL.mdviene caricato nella finestra di contesto. E poi, solo se necessario, anche gli altri file nelle cartelle scripts/, references/ e assets/ vengono caricati nel contesto.

Quindi, come si usano queste Skills?

skills.sh

A seconda dell’interfaccia LLM che usi, puoi scaricarle e salvarle nelle posizioni adatte per quell’applicazione. Ad esempio:

Anche qui, le Skills sono solo cartelle con file, quindi puoi copiarle e incollarle in queste directory e tutto funzionerà.

L’altra opzione è usareskills.sh. 

Questa è una Agent Skills Directory creata da Vercel che ti permette di scoprire le Skills in base a quanto vengono usate. Puoi anche usare uno strumento CLI che hanno sviluppato per aggiungere queste skill ai tuoi progetti o al tuo utente globale.

Per farlo, esegui il comandonpx skills add <owner/repo>, che ti guida in tutto il processo. Il comando è in pratica un copia-incolla, ma più veloce.

Usare le Skills

Una volta installate (sia conskills.shche con il copia-incolla), usarle è molto semplice. Qualunque editor tu stia usando dovrebbeautomaticamenteusare la skill ogni volta che la ritiene utile. In teoria, una volta caricata la skill nella posizione corretta, non devi più pensarci.

MAal momento in cui scrivo, non sempre utilizza le Skills nei momenti giusti. Quindi, se sai che dovrebbe usare una skill in un certo momento, dillo all’LLM.

Ad esempio, ho installato le skill di speech-to-text di ElevenLabs. Se voglio che Claude le usi, posso inviare il seguente prompt:

Usa la skill di speech to text per implementare un esempio semplice in questo progetto. Usa questo come audiohttps://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3.

È riuscito a creare l’app qui sotto al primo tentativo.

Ovviamente questa UI va migliorata molto, ma la logica di ElevenLabs funziona ed è solida. Tutto con una sola frase.

Ti consiglio vivamente di sfruttare le Agent Skills nei tuoi progetti. Offrono al tuo LLM il contesto giusto per un compito specifico, curato da chi ha creato gli strumenti.

E se usi ElevenLabs nei tuoi progetti, installa le nostre skill con:

npx skills add elevenlabs/skills