Hermes Agent Skills: installare e creare una skill

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, poi passa alle skill.

Che cos’è una skill in Hermes Agent?#

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.

Il formato è aperto e compatibile con la specifica Agent Skills, 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?#

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. Con ogni hermes update, Hermes aggiorna anche le skill integrate preservando le tue modifiche.

Come si installa una skill pronta dal catalogo?#

1. Cerca nel catalogo

   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

   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

   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à:

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?#

Ci sono tre modi per installarla:

# 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 '<OFFICIAL_URL>'

# 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.

Come si usa una skill dopo l’installazione?#

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. È anche un modo pratico per usare le skill dal telefono.

Come si crea una skill personale: cosa va inserito in SKILL.md?#

Puoi copiare questa skill e adattarla alle tue esigenze:

---
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/.

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.

Quando il file è pronto, segui questi passaggi:

1. Crea la cartella della skill

   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?#

/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?#

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?#

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?#

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?#

Per continuare su questo argomento: come collegare Hermes Agent a Telegram, così puoi richiamare le skill dal telefono, e come mantenere un agente attivo su un server 24 ore su 24, se vuoi programmare le skill. Se stai scegliendo un agente, consulta il confronto OpenClaw o Hermes Agent.