Come usare le Agent Skills

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

E la parte migliore? 

Le aziende stanno scrivendo 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, disponibili qui.)

All'interno di questa cartella puoi inserire altre informazioni, a cui il file SKILL.md può fare riferimento, ma che vengono caricate nel contesto solo quando opportuno. 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ò usare.

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 informazioni, che fatica a completare l'attività.

Immagina di fornire a uno sviluppatore junior la documentazione esatta per una funzionalità specifica, senza nulla di irrilevante. Dopo averla letta, avrebbe alte probabilità di riuscire a implementarla.

Ora immagina di chiedere allo sviluppatore junior di leggere TUTTA la documentazione e poi di implementare una funzionalità specifica tratta da una piccola parte di essa. Le probabilità di successo sarebbero molto più basse.

Gli LLM si comportano allo stesso modo. 

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

Le Skills sono diverse.

Per impostazione predefinita, nel context window vengono caricati solo il nome e la descrizione del frontmatter. Questo occupa pochissimo contesto, ma fornisce all'LLM informazioni sui tipi di skill disponibili. Quando una Skill viene ritenuta utile, il file SKILL.md viene caricato nel context window. Poi, solo quando necessario, vengono caricati nel contesto anche 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 salvarle nelle posizioni appropriate per quell'applicazione. Ad esempio:

Ancora una volta, 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 uno 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 guiderà nell'intero processo. Il comando non fa altro che copiare e incollare, ma è più veloce.

Usare le Skills

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

MA, al momento in cui scrivo, non usa sempre le Skills nei momenti giusti. Quindi, se sai che dovrebbe usare una skill in un determinato momento, dillo all'LLM. 

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

È riuscito a creare l'app qui sotto in un solo tentativo.

Naturalmente, questa UI necessita di molti miglioramenti, ma la logica principale 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, curato dalle persone che hanno creato gli strumenti.

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

npx skills add elevenlabs/skills