# Hermes Agent Skills: installare e creare una skill > Directory e GitHub, il formato SKILL.md, /learn, verifica, aggiornamento e rimozione delle skill di Hermes Agent con esempi completi di comandi. Source: https://ailoot.ai/blog/it/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/it/hermes-agent-skills/ Language: it Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-6d518d06f711932b33ec2ad0f77ca05f822551f4176a3232b41d41460ee2a033 Una skill è un’istruzione salvata per un agente: descrivi una volta come svolgere un’attività e, da quel momento, Hermes la applica quando richiami `/skill-name`, senza bisogno di ripetere le spiegazioni. Una skill pronta si può installare con un solo comando e puoi crearne una tua in due modi: scrivendo manualmente SKILL.md oppure usando `/learn`. Se non hai ancora installato Hermes, comincia dalla guida [cos’è questo agente e come installarlo](https://ailoot.ai/blog/it/hermes-agent-install-setup/), poi passa alle skill.
Le istruzioni pratiche per usare Ailoot sono nella [documentazione](https://ailoot.ai/docs/).
## Che cos’è una skill in Hermes Agent?
Punto chiave Una skill è un file che contiene istruzioni per un agente: cosa fare, quali comandi usare, a cosa prestare attenzione e dove si verificano spesso gli errori. È archiviata nella cartella `~/.hermes/skills/` come file SKILL.md, insieme agli eventuali materiali di supporto. Dopo l’installazione, la skill diventa automaticamente un comando `/name` in qualsiasi chat con l’agente.
Scrivi un prompt in un messaggio all’agente. Una skill viene archiviata in un file separato e Hermes può usare quell’istruzione nelle attività future. L’agente ha accesso a un elenco di nomi e descrizioni e carica il testo completo della skill quando è pertinente all’attività. Questo occupa meno spazio nel contesto: non tutte le istruzioni vengono caricate contemporaneamente. Una skill da sola non fornisce all’agente nuovi strumenti né accessi: descrive come usare gli strumenti che ha già. Una nuova integrazione con un servizio esterno si gestisce tramite MCP, un argomento distinto. Se un’attività richiede una logica di programma precisa, un’autorizzazione speciale o l’elaborazione di flussi di eventi, servono strumenti per l’agente: una skill da sola non basta. Scegli una skill pronta per un’attività standard se le sue istruzioni sono adatte e la fonte è stata verificata. Scrivine una tua quando devi conservare una particolare sequenza di azioni, vincoli e formato di output. Usa `/learn` se hai già del materiale o hai completato un processo e non vuoi scrivere il file manualmente.

Le skill sono documenti che contengono le informazioni necessarie a un agente, che le carica solo quando servono.

— Documentazione di Hermes Agent (tradotta dall’inglese), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
Il formato è aperto e compatibile con la [specifica Agent Skills](https://agentskills.io/specification), quindi le skill di altri cataloghi di solito funzionano in Hermes senza modifiche al formato, anche se una skill specifica potrebbe richiedere strumenti o chiavi propri. Se vuoi, puoi anche condividere una skill creata da te. ## Quali skill sono già installate e dove sono archiviate?
Punto chiave Per impostazione predefinita, le skill sono archiviate nella cartella `~/.hermes/skills/`, organizzate in sottocartelle per categoria (se usi un profilo non standard o la variabile HERMES_HOME, il percorso sarà diverso; `hermes config path` lo mostrerà). Dopo l’installazione, Hermes include già decine di skill integrate, dalla ricerca su arXiv al lavoro con GitHub e i documenti. Il comando `hermes skills list` mostra l’elenco e puoi chiedere all’agente in chat quali skill ha a disposizione.
La cartella è organizzata così: ``` ~/.hermes/skills/ ├── research/ │ └── arxiv/ │ ├── SKILL.md │ └── scripts/ ├── productivity/ │ └── pdf/ │ ├── SKILL.md │ └── references/ └── .hub/ ``` SKILL.md è l’unico file obbligatorio. Tutto il resto si aggiunge quando serve: `references/` per materiali più lunghi, `scripts/` per programmi di supporto e `templates/` e `assets/` per modelli e file. Il catalogo integrato comprende skill per le attività quotidiane: trovare GIF, lavorare con PDF, fogli di calcolo, YouTube, GitHub e note. L’elenco completo con le descrizioni si trova nella pagina del [catalogo delle skill integrate](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog). Con ogni `hermes update`, Hermes aggiorna anche le skill integrate preservando le tue modifiche. ## Come si installa una skill pronta dal catalogo?
Punto chiave Apri il catalogo con `hermes skills browse`, trova ciò che ti serve con `hermes skills search`, consulta la scheda di una skill con `hermes skills inspect` e installala con `hermes skills install`. Ogni skill viene sottoposta a un controllo di sicurezza prima dell’installazione e le skill ufficiali non attivano un avviso relativo a fonti di terze parti.
1. ### Cerca nel catalogo ```bash hermes skills search pdf ``` La ricerca viene eseguita in tutte le fonti collegate. Per vedere l’intero catalogo senza filtri, esegui `hermes skills browse`. 2. ### Consulta la scheda della skill ```bash hermes skills inspect skills-sh/anthropics/skills/pdf ``` La scheda mostra la descrizione, la fonte e il livello di attendibilità. Non installare la skill di qualcun altro senza averne letto la scheda. 3. ### Installala ```bash hermes skills install skills-sh/anthropics/skills/pdf ``` Hermes scarica SKILL.md e i file di supporto, esegue un controllo di sicurezza e salva tutto in `~/.hermes/skills/`. La skill è subito disponibile come comando `/pdf`. Se la skill richiede strumenti o chiavi aggiuntivi, sono indicati nel suo SKILL.md e Hermes te lo comunicherà durante l’installazione. Il controllo di sicurezza cerca tentativi di inviare dati all’esterno, istruzioni iniettate per l’agente e comandi che potrebbero eliminare o danneggiare file. Le fonti hanno diversi livelli di attendibilità: | Livello | Fonte della skill | Cosa succede durante l’installazione | |----|----|----| | Integrata | Inclusa in Hermes | Già presente; non serve installarla | | Ufficiale | La cartella delle skill facoltative nel repository Hermes | Installata senza avviso relativo a fonti di terze parti: `hermes skills install official/security/1password` | | Attendibile | I repository openai/skills, anthropics/skills, huggingface/skills e NVIDIA/skills | Controllo meno severo | | Altra | Cataloghi, repository GitHub di altre persone, link diretti | Avviso e controllo completo | Se il controllo mostra un avviso, puoi continuare l’installazione con il flag `--force`, ma prima leggi quale rischio ha rilevato. Un esito “dangerous” non può essere ignorato. Il controllo da solo non garantisce la sicurezza: prima di eseguire per la prima volta la skill di qualcun altro, leggi le sue istruzioni e i comandi di supporto. ## Come si installa una skill da GitHub o da un link?
Punto chiave Installa una skill da GitHub con `hermes skills install owner/repository/path` oppure usa un link diretto a un file SKILL.md: Hermes scaricherà i file di supporto. Puoi collegare una fonte di skill personale con `hermes skills tap add`, dopodiché funzionerà come qualsiasi altro catalogo.
Ci sono tre modi per installarla: ```bash # 1. Una skill specifica da un repository GitHub (il percorso all'interno del repository segue il suo nome) hermes skills install anthropics/skills/skills/pdf # 2. Un link diretto a SKILL.md su qualsiasi sito (condividi questa skill in una chat) hermes skills install '' # 3. Collega un intero repository come fonte (sostituisci con il tuo proprietario e repository) hermes skills tap add myorg/skills-repo hermes skills install myorg/skills-repo/deploy-runbook ``` Con un link diretto, Hermes scarica SKILL.md e soltanto i file delle sottocartelle del servizio menzionati al suo interno; non scarica file non pertinenti dal sito. Il link viene ricordato come fonte e, in seguito, `hermes skills update` aggiornerà la skill dallo stesso indirizzo. Oltre a GitHub, è possibile collegare cataloghi esterni di skill. Puoi trovare skill in questi cataloghi con lo stesso comando `hermes skills search`, specificando la fonte.
Attenzione GitHub limita le richieste non autenticate a 60 all’ora. Se ricevi errori di limite di richieste durante l’installazione o la ricerca, aggiungi `GITHUB_TOKEN` al file `~/.hermes/.env`; il limite salirà a 5000 richieste all’ora.
## Come si usa una skill dopo l’installazione?
Punto chiave Una skill installata diventa automaticamente un comando: digita `/skill-name` e l’attività sulla stessa riga. Non serve attivarla separatamente. Funziona nel terminale, nell’interfaccia web e nei messaggeri tramite il gateway. Puoi richiamare fino a cinque skill in un solo messaggio oppure trasformare una combinazione ricorrente in un unico comando.
Inserisci i comandi `hermes ...` nel terminale e le invocazioni `/skill-name` in una chat con l’agente (nello stesso terminale, nell’interfaccia web o in un messaggero): ``` /gif-search funny cats /github-pr-workflow create a PR for the authorization rewrite ``` Se inserisci `/skill-name` senza un’attività, Hermes caricherà le istruzioni e ti chiederà cosa vuoi che faccia. Puoi richiamare diverse skill su una riga, fino a cinque; il testo restante diventa l’attività: ``` /github-pr-workflow /test-driven-development close issue 123 and open a PR ``` Per le combinazioni che usi regolarmente, ci sono i bundle di skill, chiamati bundle nella terminologia di Hermes: `hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development` raggruppa diverse skill sotto un breve comando `/backend-dev`. Un bundle funge da alias; le skill al suo interno devono essere già installate. I comandi slash funzionano anche su Telegram se il gateway è collegato; la configurazione è descritta nella guida [come collegare Hermes Agent a Telegram](https://ailoot.ai/blog/it/hermes-agent-telegram-setup/). È anche un modo pratico per usare le skill dal telefono. ## Come si crea una skill personale: cosa va inserito in SKILL.md?
Punto chiave Una skill personale è una cartella in `~/.hermes/skills/` con un file obbligatorio, SKILL.md: una breve intestazione con nome e descrizione, seguita da istruzioni organizzate in sezioni: quando usarla, la sequenza di azioni, gli errori comuni e la verifica. È scritta in testo semplice; non serve programmare. Per una versione semplice bastano una cartella e un file.

Le skill sono il modo principale per aggiungere nuove capacità a Hermes Agent: sono più facili da creare degli strumenti, non richiedono modifiche al codice dell’agente e si possono condividere con la community.

— Documentazione di Hermes Agent (tradotta dall’inglese), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
Puoi copiare questa skill e adattarla alle tue esigenze: ```markdown --- name: weekly-review description: Weekly review: what got done, what stalled, plan for next week version: 1.0.0 metadata: hermes: tags: [planning, review] --- # Weekly review ## When to Use When the user asks to review the week or put together a plan for the next one. ## Procedure 1. Get the week's task list from the file the user provided, or ask them for it. 2. Sort the tasks into three groups: done, stalled, and new. 3. Name three priorities for the coming week. ## Pitfalls - Don't invent tasks that aren't in the original list. ## Verification Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.” ``` L’intestazione tra i tre trattini contiene i metadati. I campi principali sono `name` (in lettere latine, con parole separate da trattini e usato per richiamare la skill come comando) e `description`. L’agente usa il campo description per decidere se la skill è adatta all’attività corrente e se deve caricarla. Se la description è vaga, la skill potrebbe non essere caricata quando serve. Seguono le sezioni di istruzioni. `When to Use` indica quando caricare la skill. `Procedure` descrive i passaggi. `Pitfalls` tratta gli errori che l’agente commette comunemente e come evitarli. `Verification` spiega come controllare il risultato. Se le istruzioni sono lunghe, sposta il contenuto principale nei file in `references/`: verranno caricati solo quando servono e inserisci i programmi di supporto in `scripts/`.
Suggerimento Metti lo scenario più comune all’inizio e i casi rari alla fine del file. Hermes legge una skill dall’inizio alla fine e questo ordine fa risparmiare spazio nel contesto.
Se una skill richiede una chiave API, dichiarala nell’intestazione usando `required_environment_variables`; non inserire il valore della chiave nel file, ma dichiara solo il nome della variabile. Hermes ti chiederà il valore una volta, al primo richiamo in un terminale locale, e poi lo fornirà automaticamente (nei messaggeri ti chiederà di configurare la chiave localmente). I campi `platforms`, `config`, `blueprint` e gli altri sono descritti nella pagina della documentazione ufficiale [Creating Skills](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills). Quando il file è pronto, segui questi passaggi: 1. ### Crea la cartella della skill ```bash mkdir -p ~/.hermes/skills/weekly-review ``` Il nome della cartella corrisponde al campo `name` nell’intestazione. 2. ### Salva SKILL.md Inserisci un file chiamato `SKILL.md` con le tue istruzioni nella cartella; puoi usare l’esempio qui sopra e adattarlo alla tua attività. 3. ### Richiama la skill e controllala Inserisci `/weekly-review` e chiedi all’agente di esaminare la tua settimana. Se segue i passaggi delle tue istruzioni, la skill funziona. ## Come si crea una skill dai materiali esistenti con /learn?
Punto chiave Il comando `/learn` crea una skill a partire da materiali esistenti: forniscigli una cartella di documentazione, il link a una pagina, i tuoi appunti o la descrizione a voce di un processo; Hermes scriverà SKILL.md seguendo convenzioni consolidate, così potrai esaminarlo. Un libro o un archivio di grandi dimensioni produrrà una skill con file separati per argomento.
``` /learn documentazione per l'API demo in ~/projects/example-docs, soprattutto la sezione sull'autenticazione /learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills /learn come ho appena pubblicato un sito sull'hosting ``` Se hai appena completato un processo complesso con l’agente, chiedi a `/learn` di salvarlo come skill mentre tutti i passaggi sono ancora nella conversazione. La volta successiva, Hermes ripeterà la procedura usando le istruzioni già pronte. Una fonte di grandi dimensioni, come un libro, una specifica o un archivio di documenti, non entra in un unico file. Hermes creerà un SKILL.md compatto con una mappa degli argomenti e sposterà i dettagli in `references/`. Questi file non occupano spazio nel contesto finché l’agente non li carica per rispondere a una domanda. Richiamare `/learn` di nuovo sullo stesso argomento aggiunge contenuti alla skill esistente invece di crearne una duplicata. ## Come si verifica che una skill funzioni?
Punto chiave Per verificarla, esegui `hermes chat --toolsets skills -q` e invia una richiesta relativa alla skill, per esempio chiedile di esaminare la settimana usando un elenco di attività. Se l’agente suddivide le attività nei gruppi indicati nelle tue istruzioni, la skill funziona. Se risponde come al solito, controlla il nome del file, la descrizione nell’intestazione e il percorso della cartella.
```bash hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment" ``` Questo è il test raccomandato dalla documentazione: esegui la skill e controlla che l’agente segua le tue istruzioni. Se non lo fa, verifica tre possibili cause. Primo, il nome della cartella o il campo `name` nell’intestazione potrebbero non corrispondere al nome che richiami. Secondo, la descrizione potrebbe non chiarire quando usare la skill; riscrivila usando le parole dell’attività stessa. Terzo, la cartella potrebbe non trovarsi in `~/.hermes/skills/`, quindi Hermes non riesce a vederla. Nota che il flag `--toolsets skills` limita gli strumenti disponibili per il test: mostra come l’agente usa l’istruzione, ma non verifica le dipendenze della skill, come i programmi esterni. `hermes skills list` nel terminale mostra esattamente cosa è installato. Le skill fanno parte di un clone AI: un modo per registrare una volta come svolgi un’attività, così l’agente può ripeterla senza promemoria. La combinazione comprende **clone AI + Second Brain + Context Engineering**. Questa combinazione aiuta a trasmettere all’agente la tua logica di lavoro e il contesto delle attività. ## Come si aggiornano e rimuovono le skill?
Punto chiave `hermes skills check` mostra quali skill installate sono state aggiornate alla fonte, `hermes skills update` scarica le nuove versioni e `hermes skills uninstall name` rimuove una skill. Le tue modifiche alla skill di qualcun altro vengono preservate durante gli aggiornamenti: Hermes ignora i file modificati. Puoi ripristinare l’originale: per una skill proveniente dall’hub, usa `hermes skills update name --force`; per una skill integrata, usa `hermes skills reset name --restore`.
```bash hermes skills check # cosa è cambiato alle fonti hermes skills update # scarica le nuove versioni hermes skills uninstall pdf # rimuove una skill dall'hub ``` Per rimuovere una skill creata manualmente, elimina la sua cartella da `~/.hermes/skills/`. Se hai personalizzato la skill di qualcun altro, `update` la lascerà intatta: Hermes confronta gli hash e ignora i file modificati per evitare di sovrascrivere il tuo lavoro. Per ripristinare l’originale di una skill proveniente dall’hub, usa `hermes skills update name --force`; per una skill integrata, usa `hermes skills reset name --restore`. Entrambi i comandi sovrascrivono le tue modifiche, quindi salva prima la tua versione. Se non ti servono le skill integrate e affollano l’elenco, `hermes skills opt-out` ne disattiva l’aggiunta durante gli aggiornamenti. Il comando `opt-out --remove` rimuoverà anche quelle che non hai modificato. ## Cosa fare se una skill non si installa o non funziona?
Punto chiave Tre problemi sono i più comuni: il limite di GitHub di 60 richieste all’ora, l’installazione bloccata dal controllo di sicurezza e il file salvato nella cartella sbagliata. Se raggiungi il limite di richieste, aggiungi `GITHUB_TOKEN`. Se il controllo blocca l’installazione, leggi il suo esito. Se Hermes non vede la skill, verifica che si trovi in `~/.hermes/skills/`.
| Sintomo | Causa | Cosa fare | |----|----|----| | Errori di limite durante la ricerca o l’installazione | Senza un token, GitHub consente fino a 60 richieste all’ora | Aggiungi `GITHUB_TOKEN` a `~/.hermes/.env` | | Installazione bloccata | Il controllo ha rilevato un rischio nel codice della skill | Leggi l’esito del controllo durante l’installazione; per ricontrollare una skill installata, esegui `hermes skills audit`. Se è un avviso, puoi continuare con `--force`; se l’esito è “dangerous”, non puoi | | Skill installata, ma `/name` non funziona | Il nome non corrisponde oppure la cartella è nel posto sbagliato | Esegui `hermes skills list` e controlla la cartella `~/.hermes/skills/` | | La skill non compare nemmeno nell’elenco | SKILL.md ha una restrizione per piattaforma o strumenti obbligatori | Apri SKILL.md e controlla i campi `platforms` e `requires_*` | | La nuova versione della skill non è stata scaricata dopo l’aggiornamento | Hai modificato il file localmente e Hermes preserva le tue modifiche | Se ti serve l’originale, usa `update name --force` per una skill dall’hub oppure `reset --restore` per una skill integrata; se la tua versione è più importante, non fare nulla | | Le skill di un altro repository non si caricano | Il repository deve essere contrassegnato come attendibile | Esegui `hermes skills trust` all’interno del repository | Hermes individua le skill nelle cartelle `.hermes/skills/` e `.agents/skills/` all’interno di un repository git. Prima di caricarle, devi contrassegnare il repository come attendibile: questi file contengono istruzioni che l’agente seguirà. Dopo, le skill del repository funzionano solo al suo interno e sono sottoposte allo stesso controllo di sicurezza. Devi contrassegnare il repository come attendibile una sola volta. ## Cosa fare per prima cosa?
Punto chiave Installa una skill pronta dal catalogo: basta un solo comando. Poi scegli un’istruzione che ripeti, passala a `/learn` e verifica il risultato con un’attività reale del tuo lavoro.
Per continuare su questo argomento: [come collegare Hermes Agent a Telegram](https://ailoot.ai/blog/it/hermes-agent-telegram-setup/), così puoi richiamare le skill dal telefono, e [come mantenere un agente attivo su un server 24 ore su 24](https://ailoot.ai/blog/it/hermes-agent-vps-24-7/), se vuoi programmare le skill. Se stai scegliendo un agente, consulta il confronto [OpenClaw o Hermes Agent](https://ailoot.ai/blog/it/openclaw-vs-hermes-agent/).
### Fonti - [Documentazione di Hermes Agent](https://hermes-agent.nousresearch.com/docs/) - [Sistema delle skill - come funzionano le skill](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Creare skill - come scrivere una skill personale](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [Catalogo delle skill integrate](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [Skill ufficiali facoltative](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Repository di Hermes Agent su GitHub](https://github.com/NousResearch/hermes-agent) - [Standard Open Agent Skills](https://agentskills.io/specification)
Puoi continuare a esplorare Ailoot su [ailoot.ai](https://ailoot.ai/).
## Domande frequenti ### Perché una skill installata non compare come comando slash? Controlla l’elenco delle skill installate, il nome del file SKILL.md, il campo name e la cartella skills del profilo attivo. Anche restrizioni su piattaforma, strumenti richiesti o attendibilità del repository possono impedirne il caricamento. ### Lo smoke test limitato alle skill verifica tutte le dipendenze? No. Verifica che l’agente carichi e segua le istruzioni. Controlla separatamente strumenti, programmi e chiavi richiesti, poi verifica un risultato reale circoscritto prima di usare il flusso completo. ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.