Hermes Agent-skills: je eigen skill installeren en maken

Een skill is een opgeslagen instructie voor een agent: je beschrijft één keer hoe een taak moet worden uitgevoerd, en daarna past Hermes die toe wanneer je /skill-name aanroept, zonder dat je de uitleg steeds opnieuw hoeft te geven. Een kant-en-klare skill kun je met één opdracht installeren. Je kunt er zelf een maken op twee manieren: schrijf SKILL.md handmatig of gebruik /learn.

Heb je Hermes nog niet geïnstalleerd? Begin dan met de gids wat deze agent is en hoe je hem installeert en ga daarna verder met skills.

Wat is een skill in Hermes Agent?#

Je schrijft een prompt in een bericht aan de agent. Een skill wordt in een apart bestand opgeslagen en Hermes kan die instructie bij toekomstige taken gebruiken. De agent heeft toegang tot een lijst met namen en beschrijvingen en laadt de volledige tekst van een skill wanneer die relevant is voor de taak. Zo bespaar je ruimte in de context: niet alle instructies worden tegelijk geladen.

Een skill op zichzelf geeft de agent geen nieuwe tools of toegang; de skill beschrijft hoe je de tools gebruikt die de agent al heeft. Een nieuwe integratie met een externe dienst regel je via MCP; dat is een apart onderwerp. Als een taak nauwkeurige programmatische logica, speciale autorisatie of verwerking van een eventstream vereist, zijn agenttools nodig; een skill alleen is niet voldoende.

Kies voor een standaardtaak een kant-en-klare skill als de instructies passen en de bron is gecontroleerd. Schrijf zelf een skill als je jouw specifieke reeks stappen, beperkingen en uitvoerindeling wilt vastleggen. Gebruik /learn als je al materiaal hebt of een proces hebt afgerond en het bestand niet handmatig wilt schrijven.

Het formaat is open en compatibel met de Agent Skills-specificatie. Daarom werken skills uit andere catalogi doorgaans zonder aanpassingen aan het formaat in Hermes, hoewel een specifieke skill eigen tools of sleutels kan vereisen. Je kunt je eigen skill ook delen.

Welke skills zijn al geïnstalleerd en waar worden ze opgeslagen?#

De mappenstructuur ziet er zo uit:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md is het enige verplichte bestand. Al het overige voeg je naar behoefte toe: references/ voor uitgebreider materiaal, scripts/ voor hulpprogramma's en templates/ en assets/ voor sjablonen en bestanden.

De ingebouwde catalogus bevat skills voor alledaagse taken: GIF's vinden, werken met pdf's, spreadsheets, YouTube, GitHub en notities. De volledige lijst met beschrijvingen staat op de pagina met de catalogus van ingebouwde skills. Bij elke opdracht hermes update werkt Hermes ook ingebouwde skills bij, waarbij je eigen wijzigingen behouden blijven.

Hoe installeer je een kant-en-klare skill uit de catalogus?#

1. Zoek in de catalogus

   hermes skills search pdf
   

   De zoekopdracht doorzoekt alle gekoppelde bronnen. Voer hermes skills browse uit om de volledige catalogus zonder filter te bekijken.

2. Bekijk de skillkaart

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   De kaart toont de beschrijving, bron en het vertrouwensniveau. Installeer de skill van iemand anders niet zonder eerst de kaart te lezen.

3. Installeer de skill

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes downloadt SKILL.md en de bijbehorende bestanden, voert een veiligheidscontrole uit en plaatst alles in ~/.hermes/skills/. De skill is meteen beschikbaar als de opdracht /pdf. Als de skill extra tools of sleutels nodig heeft, staan die vermeld in SKILL.md en laat Hermes je dat tijdens de installatie weten.

De veiligheidscontrole zoekt naar pogingen om gegevens naar buiten te sturen, geïnjecteerde instructies voor de agent en opdrachten die bestanden kunnen verwijderen of beschadigen. Bronnen hebben verschillende vertrouwensniveaus:

Als de controle een waarschuwing geeft, kun je de installatie voortzetten met de vlag --force, maar lees eerst welk risico is gevonden. Een oordeel ‘gevaarlijk’ kan niet worden omzeild. De controle zelf garandeert geen veiligheid: lees de instructies en bijbehorende opdrachten voordat je een skill van iemand anders voor het eerst uitvoert.

Hoe installeer je een skill vanaf GitHub of via een link?#

Er zijn drie manieren om te installeren:

# 1. Een specifieke skill uit een GitHub-repository (het pad binnen de repository volgt op de naam)
hermes skills install anthropics/skills/skills/pdf

# 2. Een directe link naar SKILL.md op een willekeurige site (deel deze skill in een chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Koppel een hele repository als bron (vervang dit door je eigen eigenaar en repository)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Via een directe link downloadt Hermes SKILL.md en alleen de bestanden die daarin worden genoemd uit submappen van de dienst; niet-gerelateerde bestanden van de site worden niet gedownload. De link wordt als bron onthouden en met hermes skills update wordt de skill later bijgewerkt vanaf hetzelfde adres.

Naast GitHub zijn er externe skillcatalogi beschikbaar. Je kunt skills daaruit vinden met dezelfde opdracht hermes skills search en de bron opgeven.

Hoe gebruik je een skill na installatie?#

Voer opdrachten van de vorm hermes ... uit in de terminal en aanroepen van de vorm /skill-name in een chat met de agent (in dezelfde terminal, de webinterface of een berichtenapp):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Als je /skill-name invoert zonder een taak, laadt Hermes de instructies en vraagt wat je wilt dat de agent doet. Je kunt meerdere skills op één regel aanroepen, maximaal vijf; de overige tekst wordt de taak:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Voor combinaties die je regelmatig gebruikt, zijn er skillbundels, in Hermes-termen bundles genoemd: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development groepeert meerdere skills onder één korte opdracht /backend-dev. Zo'n bundle werkt als een alias; de skills erin moeten vooraf geïnstalleerd zijn.

Slash-opdrachten werken ook in Telegram als de gateway is verbonden; de configuratie wordt uitgelegd in de gids zo verbind je Hermes Agent met Telegram. Dit is ook een handige manier om skills vanaf je telefoon uit te voeren.

Hoe maak je je eigen skill: wat zet je in SKILL.md?#

Je kunt deze skill kopiëren en naar wens aanpassen:

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

De header tussen de drie streepjes bevat metadata. De belangrijkste velden zijn name (in Latijnse letters, met koppeltekens ertussen, en gebruikt om de skill als opdracht aan te roepen) en description. De agent gebruikt het beschrijvingsveld om te bepalen of de skill bij de huidige taak past en moet worden geladen. Als de beschrijving vaag is, wordt de skill mogelijk niet geladen wanneer dat nodig is.

Na de header volgen secties met instructies. When to Use geeft aan wanneer de skill moet worden geladen. Procedure beschrijft de stappen. Pitfalls behandelt waar de agent vaak fouten maakt en hoe die te voorkomen zijn. Verification legt uit hoe je het resultaat controleert. Zijn de instructies lang, verplaats dan de hoofdinhoud naar bestanden in references/; die worden alleen geladen wanneer ze nodig zijn. Zet hulpprogramma's in scripts/.

Als een skill een API-sleutel nodig heeft, vermeld die dan in de header met required_environment_variables; zet de sleutel zelf niet in het bestand, maar vermeld alleen de naam van de variabele. Hermes vraagt de waarde één keer bij het eerste gebruik in een lokale terminal en levert die daarna automatisch aan (in berichtenapps vraagt Hermes je de sleutel lokaal in te stellen). De velden platforms, config, blueprint en andere worden beschreven op de officiële documentatiepagina Skills maken.

Volg deze stappen zodra het bestand klaar is:

1. Maak de skillmap

   mkdir -p ~/.hermes/skills/weekly-review
   

   De mapnaam komt overeen met het veld name in de header.

2. Sla SKILL.md op

   Plaats een bestand met de naam SKILL.md en je instructies in de map; je kunt het bovenstaande voorbeeld gebruiken en aanpassen aan je taak.

3. Roep de skill aan en controleer hem

   Voer /weekly-review in en vraag de agent je week te evalueren. Als de agent de stappen in je instructies volgt, werkt de skill.

Hoe maak je met /learn een skill van bestaand materiaal?#

/learn documentatie voor de demo-API in ~/projects/example-docs, vooral het gedeelte over authenticatie
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn hoe ik zojuist een site naar hosting heb gepubliceerd

Heb je net samen met de agent een ingewikkeld proces afgerond, vraag /learn dan om het als skill op te slaan zolang alle stappen nog in het gesprek staan. De volgende keer herhaalt Hermes de procedure aan de hand van de kant-en-klare instructies.

Een grote bron, zoals een boek, specificatie of documentarchief, past niet in één bestand. Hermes maakt dan een compacte SKILL.md met een overzicht van onderwerpen en verplaatst de details naar references/. Deze bestanden nemen geen context in beslag totdat de agent ze laadt om een vraag te beantwoorden. Als je /learn opnieuw voor hetzelfde onderwerp aanroept, voegt het materiaal toe aan de bestaande skill in plaats van een duplicaat te maken.

Hoe controleer je of een skill werkt?#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

Dit is de test die de documentatie aanbeveelt: voer de skill uit en controleer of de agent je instructies volgt. Doet de agent dat niet, controleer dan drie mogelijke oorzaken. Ten eerste komen de mapnaam of name in de header mogelijk niet overeen met de naam die je aanroept. Ten tweede maakt de beschrijving mogelijk niet duidelijk wanneer de skill moet worden gebruikt; herschrijf de beschrijving met de woorden die je voor de taak zelf zou gebruiken. Ten derde staat de map misschien niet in ~/.hermes/skills/, waardoor Hermes de skill niet kan vinden. Houd er rekening mee dat de vlag --toolsets skills de beschikbare toolset voor de test beperkt: de test laat zien hoe de agent met de instructie werkt, maar controleert geen afhankelijkheden van de skill, zoals externe programma's.

De opdracht hermes skills list in de terminal toont precies wat er is geïnstalleerd.

Skills maken deel uit van een AI-kloon: een manier om één keer vast te leggen hoe je een taak uitvoert, zodat de agent die zonder herinneringen kan herhalen. De combinatie bestaat uit AI-kloon + Tweede brein + Contextengineering. Zo kun je jouw werkwijze en de context van een taak aan de agent overbrengen.

Hoe werk je skills bij en hoe verwijder je ze?#

hermes skills check      # wat er bij de bronnen is gewijzigd
hermes skills update     # nieuwe versies downloaden
hermes skills uninstall pdf   # een skill uit de hub verwijderen

Wil je een skill verwijderen die je handmatig hebt gemaakt, verwijder dan de map ervan uit ~/.hermes/skills/. Heb je de skill van iemand anders aangepast, dan laat update die met rust: Hermes vergelijkt hashes en slaat gewijzigde bestanden over om te voorkomen dat je werk wordt overschreven. Gebruik voor een skill uit de hub hermes skills update name --force om de oorspronkelijke versie te herstellen, en voor een ingebouwde skill hermes skills reset name --restore. Beide opdrachten overschrijven je wijzigingen, dus sla eerst je eigen versie op.

Heb je de ingebouwde skills niet nodig en maken ze de lijst onoverzichtelijk, dan schakelt hermes skills opt-out het toevoegen ervan bij updates uit. Met de opdracht opt-out --remove worden ook de skills verwijderd die je niet hebt gewijzigd.

Wat doe je als een skill niet wil installeren of niet werkt?#

Hermes vindt skills in de mappen .hermes/skills/ en .agents/skills/ binnen een Git-repository. Voordat Hermes ze laadt, moet je de repository als vertrouwd markeren: deze bestanden bevatten instructies die de agent zal volgen. Daarna werken skills uit de repository alleen daarbinnen en ondergaan ze dezelfde veiligheidscontrole. Je hoeft de repository maar één keer als vertrouwd te markeren.

Wat kun je het beste eerst doen?#

Lees hierna verder over hoe je Hermes Agent met Telegram verbindt, zodat je skills vanaf je telefoon kunt aanroepen, en over hoe je een agent dag en nacht op een server laat draaien als je skills volgens een schema wilt uitvoeren. Ben je een agent aan het kiezen, bekijk dan de vergelijking OpenClaw of Hermes Agent.