Agent skills: zo leer je een AI-agent een vaste werkwijze

Agent skills zijn vaste werkwijzen die je een AI-agent meegeeft. Een skill is een map met een instructiebestand en soms scripts of voorbeelden. De agent opent die pas wanneer een taak erom vraagt. Zo hoef je niet elke keer opnieuw uit te leggen hoe je team een offerte maakt, een rapport schrijft of een controle uitvoert.

Het woord skills kom je overal tegen bij AI-agenten. Maar wat is een skill precies, en wat is het verschil met een prompt, een tool of een MCP-server? In dit artikel lees je hoe een skill eruitziet en hoe Hermes ermee werkt. Je leest ook hoe je skills in een team beheert en waar het risico zit bij skills van anderen.

Een rij donkere platen op een zwarte sokkel, waarvan één kobaltblauwe plaat omhoog komt en zacht oplicht
Een skill ligt klaar tot een taak erom vraagt. Pas dan opent de agent de werkwijze.

Wat zijn agent skills?

Een skill is een map met minstens één bestand: SKILL.md. Bovenaan dat bestand staan een naam en een korte beschrijving. Daaronder staat de werkwijze zelf: de stappen in de juiste volgorde, de valkuilen en hoe je controleert of het gelukt is. In dezelfde map kunnen ook scripts, naslagwerk en sjablonen staan. Zo beschrijft de open standaard Agent Skills het.

Een kleine skill voor het voorbeeld van de offerte kan er zo uitzien:

---
name: offerte-schrijven
description: Gebruik bij een offerte voor een nieuwe klant.
---
1. Lees de aanvraag van de klant en noteer wat die vraagt.
2. Vul het offertesjabloon in templates/offerte.md in.
3. Controleer elke prijs met de actuele prijslijst.
4. Stuur het concept naar een collega voordat het vertrekt.

Anthropic ontwikkelde het formaat en gaf het in december 2025 vrij als open standaard. Volgens de specificatie zijn alleen de naam en de beschrijving verplicht. De naam mag maximaal 64 tekens lang zijn, de beschrijving maximaal 1.024. Een skill is dus gewone tekst die je kunt lezen, aanpassen en bewaren in versiebeheer. Veel agenten en programmeertools werken met dit formaat, ook Hermes. Een skill die je één keer schrijft, kun je zo in meerdere tools gebruiken.

Hoe weet een agent welke skill het nodig heeft?

Een agent leest niet alle skills tegelijk. Dat gebeurt in drie stappen. Bij de start kent de agent alleen de naam en de beschrijving van elke skill. Past een taak bij een beschrijving, dan leest de agent de volledige instructies. Tijdens het werk opent het daarna de scripts of het naslagwerk die erbij horen, maar alleen als dat nodig is.

Daarom is de beschrijving zo belangrijk. Staat er vaag "helpt met documenten", dan weet de agent niet wanneer de skill past. Een goede beschrijving zegt wanneer je de skill gebruikt, bijvoorbeeld "gebruik bij een offerte voor een nieuwe klant". En omdat alleen die korte beschrijvingen altijd meegaan, kan een agent veel skills klaar hebben zonder dat elk gesprek zwaar wordt. Volgens de specificatie kost die eerste stap ongeveer 100 tokens per skill, en blijft het volledige SKILL.md bij voorkeur onder 5.000 tokens. De documentatie van Anthropic noemt dezelfde cijfers.

Skill, prompt, tool of MCP-server: wat is het verschil?

Een prompt is een losse opdracht en een skill is een vaste werkwijze. Een tool is een functie die de agent uitvoert, een MCP-server is een koppeling met een ander systeem en het geheugen bevat korte feiten. Ze werken samen, maar ze doen elk iets anders. Een MCP-server geeft de agent toegang tot een systeem, zoals je CRM. Een skill beschrijft hoe de agent een taak in dat systeem aanpakt. Heeft de agent geen toegang tot een systeem, dan lost een skill dat niet op: dan heb je eerst een tool of een MCP-server nodig. Meer over zulke koppelingen lees je in wat is MCP.

BegripWat het isHoe lang het blijftVoorbeeld

Prompt

Een opdracht die je in het gesprek typt

Alleen in dat gesprek

"Vat deze mail samen in drie zinnen"

Skill

Een vaste werkwijze in een map met SKILL.md

Blijft staan; de agent opent de skill als een taak erom vraagt

Hoe je team een offerte maakt, stap voor stap

Tool

Een functie die de agent zelf kan uitvoeren

Zolang de tool aanstaat

Een webpagina ophalen of een bestand lezen

MCP-server

Een koppeling die tools en gegevens van een ander systeem aanbiedt via een open protocol

Zolang de koppeling actief is

Klantgegevens opzoeken in je CRM

Geheugen

Korte feiten die de agent altijd meeneemt

In elk gesprek

Je naam, je rol en je voorkeuren

Hoe werkt Hermes met skills?

Hermes Agent volgt dezelfde open standaard. Volgens de documentatie over skills staan alle skills in één map per profiel. Elke skill is ook een commando. Typ een schuine streep en de naam van de skill, in de terminal of in een chatkanaal, en de agent opent die werkwijze meteen.

Hermes schrijft ook zelf skills. Heeft de agent een taak met meerdere stappen uitgezocht, een fout opgelost of stuur jij de aanpak bij, dan legt het dat vast als skill. De volgende keer begint de agent niet opnieuw. Met het commando /learn maak je zelf een skill van een handleiding, een webpagina of een werkwijze die je net hebt voorgedaan. Kleine feiten die altijd gelden, bewaart Hermes in het geheugen. Langere werkwijzen komen in een skill.

Standaard schrijft Hermes die skills zonder te vragen. Wil je elke wijziging eerst zien, zet dan de goedkeuring voor skills aan. Een nieuwe of aangepaste skill wacht dan tot jij die goedkeurt. Voor een bedrijf is dat vaak de betere keuze. Wat Hermes verder doet, lees je in Hermes Agent uitgelegd. Hoe Voltti de agent voor bedrijven installeert, staat op de pagina over de Hermes AI-agent.

Hoe beheer je skills in een team?

Ons advies voor teams: zet de agent skills, plug-ins en MCP-servers van je team in een GitHub-repo van je eigen bedrijf. Zet ze van daaruit op elke Hermes-installatie. Een skill die alleen op de laptop van één collega staat, helpt de rest van het team niet. En als iedereen een eigen versie bijhoudt, doet de agent hetzelfde werk op drie manieren. Met één gedeelde repo werkt het team aan één werkwijze en zie je wie wat heeft veranderd.

Hermes ondersteunt dat op een paar manieren. Je kunt een GitHub-repo met skills als bron toevoegen en de skills daaruit installeren. Je kunt Hermes ook een extra map laten lezen, bijvoorbeeld een kopie van die repo op de computer waar de agent draait. En je kunt de skills die de agent zelf schrijft, in een map laten komen die onder versiebeheer staat. Zo pak je het aan:

  • Begin klein, met één skill voor een taak die elke week terugkomt, zoals een rapport of een offerte.

  • Schrijf een beschrijving die zegt wanneer de skill past, en houd de werkwijze kort en concreet.

  • Laat een wijziging aan een skill nakijken door een collega, zoals je dat ook met code doet.

  • Zet de goedkeuring voor skills aan, zodat de agent de werkwijze van het team niet zomaar aanpast.

  • Let op met een gedeelde map. Volgens de documentatie kan Hermes skills aanpassen in een gedeelde map als het daar mag schrijven. Wil je dat niet, geef de agent daar dan alleen leesrechten.

Werkt je bedrijf met meerdere afdelingen, dan kan elke afdeling een eigen profiel krijgen, met eigen skills. Hoe dat werkt, lees je in Hermes voor teams.

Kun je skills van anderen gebruiken?

Ja, en dat kan handig zijn: er bestaan publieke verzamelingen met duizenden agent skills. Maar een skill is meer dan tekst. Er kunnen scripts in zitten die de agent uitvoert. Er kunnen ook instructies in staan die de agent iets laten doen wat je niet wilt. Een studie uit januari 2026 (een preprint) onderzocht 31.132 skills uit twee grote publieke marktplaatsen. In 26,1 % ervan zat minstens één kwetsbaarheid.

Hermes laat een skill uit een externe bron eerst door een beveiligingsscan gaan. Die zoekt onder meer naar het weglekken van gegevens, verborgen opdrachten en commando’s die schade aanrichten. Een skill die de scan als gevaarlijk ziet, installeert Hermes niet, ook niet als je dat probeert te forceren. Een scan vervangt wel geen eigen controle. Lees een skill na voor je die installeert, en kijk vooral naar de scripts. Anthropic geeft hetzelfde advies: installeer alleen skills uit bronnen die je vertrouwt.

Meer maatregelen vind je in onze checklist voor AI en bedrijfsgegevens. Hoe Hermes zich verhoudt tot een andere open-source agent met eigen skills, lees je in Hermes vs OpenClaw.

Hoe gebruikt Voltti zelf skills?

Onze eigen Hermes-installatie bij Voltti werkt met skills voor werk dat terugkomt. Een skill voor het plannen van content legt bijvoorbeeld vast welke gegevens uit Search Console de agent ophaalt en hoe het daar een planning voor nieuwe artikelen van maakt. Elke omgeving heeft eigen instellingen en eigen skills. Zo gebruikt de agent voor de ene opdracht niet de werkwijze van een andere. Onze kennisbank houdt de agent bij met de officiële skill llm-wiki, die je bij Hermes apart installeert. Die kennisbank heeft per onderwerp een notitie met de bronnen erbij, plus een index en een logboek. Bij een security audit volgt de agent eigen Voltti-skills, met vaste werkinstructies per soort controle. Hoe dat loopt, lees je in hoe Voltti een security audit uitvoert.

Een skill maakt een agent niet slimmer dan het taalmodel erachter. Een skill zorgt er wel voor dat de agent dezelfde taak elke keer op dezelfde manier aanpakt, met de lessen van de vorige keer erbij. Hoe een agent zulk werk ook volgens een schema en met hulpagenten uitvoert, lees je in agentic workflow.

Waar begin je met agent skills?

Kies één taak die je collega’s elke week op dezelfde manier doen, en schrijf op hoe dat gaat. Dat is je eerste skill. Laat de agent de taak een paar keer uitvoeren, vergelijk het resultaat met het werk van je team en verbeter de skill. In een pilot test je dat met de rechten die de taak nodig heeft, en niet meer. Een pilot duurt meestal 2 tot 4 weken, van het eerste gesprek tot de evaluatie. Hoe dat verloopt, lees je in onze aanpak.

Portretfoto van Seppe Gadeyne

Seppe Gadeyne is developer en eigenaar van Voltti. Hij richt AI-agenten in voor bedrijven in België en Nederland.

Bijgewerkt op

Veelgestelde vragen

01Wat is het verschil tussen een skill en een prompt?

Een prompt is een opdracht voor één gesprek. Een skill is een vaste werkwijze die blijft staan. De agent opent de skill zelf wanneer een taak erom vraagt, of jij roept die op met een commando. Zo hoef je dezelfde uitleg niet telkens opnieuw te typen.

02Wat is het verschil tussen een skill en een MCP-server?

Een MCP-server geeft de agent toegang tot een ander systeem, zoals je CRM of je agenda. Een skill beschrijft hoe de agent een taak aanpakt, ook met die toegang. Vaak gebruik je ze samen: de koppeling haalt de gegevens op, de skill zegt wat de agent ermee doet.

03Kan ik skills van anderen gebruiken?

Ja, maar lees ze eerst na. Een skill kan scripts en instructies bevatten die je niet wilt. Een studie uit januari 2026 vond in 26,1 % van de onderzochte skills uit publieke marktplaatsen minstens één kwetsbaarheid. Hermes scant skills uit externe bronnen voor de installatie, maar die scan vervangt je eigen controle niet.

04Waar bewaar je skills voor een team?

Wij adviseren een GitHub-repo van je eigen bedrijf voor de skills, plug-ins en MCP-servers van je team. Van daaruit zet je ze op elke Hermes-installatie. Hermes kan die repo als bron toevoegen, of een kopie ervan lezen als extra map met skills. Zo werkt iedereen met dezelfde werkwijze, en laat je een wijziging eerst door een collega nakijken.

05Werken agent skills ook buiten Hermes?

Ja. Agent Skills is een open standaard, en een skill die de specificatie volgt, kun je gebruiken in elke agent of programmeertool die het formaat ondersteunt. Op de lijst met ondersteunde tools staan onder meer Claude Code, Codex, Cursor, GitHub Copilot en Gemini CLI, en ook Hermes Agent. Een skill die je voor Hermes schrijft, kun je dus ook in die tools gebruiken.

Welke werkwijze wil je je agent leren?

Bespreek je pilot