Come usare le Agent Skills

Le Agent Skills sono uno dei modi più efficaci per usare gli LLM. Forniscono il contesto adatto per svolgere l'attività che vuoi completare in modo ripetibile. 

E la parte migliore? 

Le aziende creano queste skill per te, quindi devi solo usarle nei tuoi workflow. In questa guida ti mostrerò come sfruttare queste skill per creare funzionalità che funzionano davvero.

Cosa sono le Skills?

Una “Skill” è una cartella con file markdown che spiegano come svolgere un'attività specifica. Il file principale della skill deve chiamarsi SKILL.md, e il suo contenuto può essere qualsiasi cosa tu voglia, purché il frontmatter contenga un campo name e un campo description. (Esistono altri campi frontmatter facoltativi, che puoi trovare qui.)

Si consiglia che questo file principale SKILL.md abbia meno di 500 righe.

All'interno di questa cartella puoi inserire altre informazioni, a cui può fare riferimento il file SKILL.md, ma che vengono caricate nel contesto solo quando necessario. Queste informazioni devono essere archiviate nelle seguenti cartelle:

1. scripts/ - Codice eseguibile che gli agenti possono eseguire.
2. references/ - Altri file markdown utilizzabili come documentazione aggiuntiva, quando necessario.
3. assets/ - Risorse statiche che l'agente può utilizzare.

Cosa rende speciali le Skills?

Uno dei maggiori problemi nell'uso dell'IA è il Context Bloat. Il context bloat si verifica quando fornisci all'IA così tanto contesto, ovvero così tante informazioni, da rendere difficile completare l'attività.

Immagina di fornire a uno sviluppatore junior la documentazione esatta per una funzionalità specifica e nulla di irrilevante. Dopo aver letto questa documentazione, avrebbe un'alta 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 tratta da una piccola parte della documentazione. La probabilità di successo sarebbe molto più bassa.

Gli LLM si comportano allo stesso modo. 

Gli approcci precedenti, come MCP, cercavano di risolvere questo problema caricando nel modello grandi quantità di contesto strutturato. Funzionavano meglio che non avere alcun contesto, ma avevano comunque difficoltà a completare le attività in modo coerente.

Le Skills sono diverse.

Per impostazione predefinita, nella finestra di contesto vengono caricati solo il nome e la descrizione dal frontmatter. Questo occupa pochissimo contesto, ma fornisce all'LLM informazioni sui tipi di skill disponibili. Quando una Skill viene considerata utile, il file SKILL.md viene caricato nella finestra di contesto. Solo quando necessario vengono poi caricati nel contesto gli altri file nelle cartelle scripts/, references/ e assets/.

Quindi, come si usano queste Skills?

skills.sh

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

Di nuovo, le Skills sono semplicemente cartelle con file, quindi puoi copiarle e incollarle in queste directory e tutto funzionerà.

L'altra opzione è usare skills.sh. 

È una directory di Agent Skills creata da Vercel che ti permette di scoprire le Skills in base alla frequenza con cui vengono utilizzate. Puoi anche usare lo strumento CLI sviluppato da Vercel per aggiungerle ai tuoi progetti o al tuo utente globale.

Per farlo, esegui il comando npx skills add <owner/repo>, che ti guida nell'intero processo. Il comando non fa altro che copiare e incollare, ma è più rapido.

Usare le Skills

Dopo averle installate, usando skills.sh o copiandole e incollandole, usarle è molto semplice. L'editor che usi dovrebbe automaticamente usare la skill ogni volta che ritiene possa essere utile. In teoria, una volta caricata nella posizione corretta, non devi più pensarci. 

MA, al momento della stesura di questo articolo, non utilizza sempre le Skills nei momenti giusti. Quindi, se sai che dovrebbe usare una skill in un determinato momento, dillo all'LLM. 

Per esempio, ho installato le skill Speech to Text di ElevenLabs. Se voglio che Claude le usi, posso inviargli il seguente prompt:

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

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

Naturalmente, questa UI ha molto margine di miglioramento, ma la logica fondamentale di ElevenLabs è solida e funziona. Tutto con una sola frase. 

Ti consiglio vivamente di usare le Agent Skills nei tuoi progetti. Forniscono al tuo LLM il contesto adatto per un'attività specifica, selezionato dalle persone che hanno creato gli strumenti.

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

npx skills add elevenlabs/skills