# AI Agent Skills: wat ze zijn en hoe je er een schrijft die werkt

> AI Agent Skills zetten instructies die je steeds herhaalt om in bestanden die je agent op verzoek inlaadt. Ontdek hoe SKILL.md werkt, bekijk voorbeelden en leer hoe je er zelf een schrijft.

Last updated: 2026-09-28T10:00:00

Canonical URL: https://crevio.co/nl/blog/ai-agent-skills

*Laatst bijgewerkt: september 2026*

**Als je je restitutiebeleid meer dan twee keer aan een AI-agent hebt uitgelegd, heb je eigenlijk al een agent-skill geschreven. Je blijft hem alleen verwijderen.** AI Agent Skills lossen dat op: een kort bestand met een procedure dat de agent alleen leest wanneer een taak daarom vraagt. Schrijf de regels één keer op, en elk volgend gesprek begint ermee.

Deze gids is voor ondernemers en operationele medewerkers die een AI-agent inzetten voor echt werk en het zat zijn om steeds opnieuw uitleg te geven. Je leest wat een skill precies is, hoe agents bepalen wanneer ze er een laden, welke taken er een verdienen en krijgt een compleet voorbeeld dat je kunt kopiëren.

- **Een skill is een map met een SKILL.md-bestand**: een naam, een korte beschrijving en de instructies. Scripts en referentiebestanden zijn optioneel
- **Agents lezen vooraf alleen de beschrijving** (ongeveer 100 tokens per skill). De rest wordt geladen wanneer een taak overeenkomt, waardoor een grote bibliotheek goedkoop blijft
- **Het is een open standaard.** Dezelfde skill werkt in Claude, ChatGPT en Codex, Gemini CLI, Cursor, GitHub Copilot en tientallen andere agents
- **De beschrijving is het belangrijkste onderdeel.** Een vage beschrijving zorgt ervoor dat de skill nooit wordt geactiveerd of voor de verkeerde taak wordt gebruikt
- **Skills van derden zijn code die je installeert.** Uit een audit van februari 2026 bleek dat 13,4% van de openbare skills kritieke beveiligingsproblemen bevatte

## Wat zijn AI Agent Skills?

**AI Agent Skills zijn herbruikbare instructiepakketten die een agent leren hoe hij één specifieke taak op jouw manier uitvoert.** Elke skill is een map met daarin een `SKILL.md`-bestand. Dat bestand begint met een korte header (een `name` en een `description`), gevolgd door instructies in gewone taal: de stappen, regels, uitvoerindeling en uitzonderingssituaties.

Het idee komt van Anthropic, dat [Agent Skills in oktober 2025 introduceerde](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) en ze omschreef als "georganiseerde mappen met instructies, scripts en hulpmiddelen die agents kunnen ontdekken en dynamisch kunnen laden". In december 2025 publiceerde het bedrijf het formaat als open standaard op [agentskills.io](https://agentskills.io/home), waarna de meeste grote agents het hebben overgenomen.

![Anthropic's engineeringpost waarin Agent Skills worden geïntroduceerd, gepubliceerd op 16 oktober 2025](https://crevio.co/vite/assets/anthropic-agent-skills-announcement-fr3rjecj.png)

De term wordt ook losjes gebruikt voor "wat AI-agents kunnen doen" of voor de menselijke vaardigheden die je nodig hebt om agents te beheren. Dat zijn relevante onderwerpen, maar wanneer mensen die agents bouwen of kopen in 2026 over "skills" praten, bedoelen ze vrijwel altijd dit: een verpakte procedure die de agent erbij kan pakken en weer kan wegleggen.

### Wat staat er in een skillmap?

De [Agent Skills-specificatie](https://agentskills.io/specification) houdt de structuur bewust klein:

| Onderdeel | Verplicht? | Wat staat erin? |
|---|---|---|
| `SKILL.md` | Ja | Header met `name` en `description`, gevolgd door de instructies |
| `scripts/` | Nee | Code die de agent kan uitvoeren, zoals een rapportgenerator of validator |
| `references/` | Nee | Langere documenten: je volledige beleid, een prijslijst of een stijlgids |
| `assets/` | Nee | Sjablonen, voorbeeldbestanden en opzoektabellen |

Voor de header gelden vaste limieten. De `name` mag maximaal 64 tekens bevatten: kleine letters, cijfers en koppeltekens. De `description` mag maximaal 1.024 tekens lang zijn en moet volgens de specificatie "beschrijven wat de skill doet en wanneer je die gebruikt".

![De Agent Skills-specificatiepagina met het vereiste SKILL.md-bestand en optionele mappen voor scripts, referenties en assets](https://crevio.co/vite/assets/agentskills-specification-idwfflfk.png)

## Hoe agents skills laden

Het slimme aan dit formaat is dat een agent niet alle skills tegelijk leest. Skills worden in drie niveaus geladen, wat de specificatie **progressive disclosure** noemt.

![Diagram van de drie niveaus die een agent laadt: naam en beschrijving altijd, SKILL.md-instructies wanneer een taak overeenkomt en referenties of scripts alleen wanneer een stap ze nodig heeft](https://crevio.co/vite/assets/how-agents-load-skills-g1wbt1jh.svg)

1. **Ontdekken.** Aan het begin van elke sessie leest de agent alleen de naam en beschrijving van elke geïnstalleerde skill, ongeveer 100 tokens per skill
2. **Activeren.** Wanneer je verzoek overeenkomt met een beschrijving, leest de agent de volledige `SKILL.md` van die skill. De specificatie raadt aan dit onder de 5.000 tokens en 500 regels te houden
3. **Uitvoeren.** De agent volgt de instructies en opent een referentiebestand of voert een script uit wanneer een stap daarnaar verwijst

Daarom kan een bedrijf tientallen skills geïnstalleerd houden zonder de agent te vertragen of te betalen voor context die hij nooit gebruikt. Het verklaart ook waarom de beschrijving zo belangrijk is: dat is het enige onderdeel dat de agent ziet voordat hij beslist. In Anthropic's [handleiding voor auteurs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) staat dat de agent op basis van dat ene veld kan kiezen uit "100+ beschikbare Skills".

## Skills versus prompts, tools en geheugen

Skills overlappen met verschillende dingen die je misschien al gebruikt. Het verschil zit in wat elk onderdeel bevat en wanneer het verschijnt.

| | Wat het bevat | Wanneer de agent het ziet | Goed voor |
|---|---|---|---|
| **Prompt** | Eén verzoek | Alleen in dit gesprek | Eenmalige taken |
| **Aangepaste instructies** | Vaste voorkeuren | Elk gesprek, altijd | Toon, naam, tijdzone |
| **Geheugen** | Feiten die de agent heeft opgepikt | Wanneer hij ze zich herinnert | "November is onze drukste maand" |
| **Tool of integratie** | Toegang tot een systeem | Wanneer hij moet handelen | Bestellingen lezen, e-mails versturen |
| **Skill** | Een procedure | Alleen wanneer de taak overeenkomt | "Zo handelen we restituties af" |

Skills en tools worden het vaakst met elkaar verward. **Een tool geeft de agent een sleutel; een skill vertelt hem wat hij eenmaal binnen moet doen.** Een skill die zegt "controleer de bestelling in onze webshop" is nutteloos als de agent geen toegang tot je webshop heeft. Omgekeerd is toegang tot je webshop riskant zonder een skill die bepaalt wat de agent daar wel en niet mag doen. Meestal heb je beide nodig.

Skills en geheugen zorgen er ook voor dat een agent niet telkens vanaf nul begint, maar beter wordt door gebruik. Dat is het onderscheid dat we uitleggen in [AI-medewerker versus AI-agent](/nl/blog/ai-employee-vs-ai-agent).

## Waar AI Agent Skills vandaag werken

Omdat het formaat een open standaard is, zit een skill die je schrijft niet vast aan één product. De [clientlijst van agentskills.io](https://agentskills.io/home) bevat Claude en [Claude Code](/nl/blog/claude-code), ChatGPT en Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code, OpenCode, Goose, Databricks, Snowflake en meer dan 30 andere agents.

Daarna volgden openbare directory's. Op [skills.sh](https://skills.sh/) vind je communityskills die je met één opdracht kunt installeren, van schrijf- en researchskills tot skills voor specifieke tools.

![skills.sh, een openbare directory met communityskills voor agents en een installatieranglijst](https://crevio.co/vite/assets/skills-sh-directory-f00n0in6.png)

Een groot deel van die bibliotheek is geschreven door ontwikkelaars, voor coding agents. De skills die belangrijk zijn voor het runnen van een bedrijf staan zelden op een ranglijst, omdat ze dingen bevatten die alleen jij weet: je beleid, je tone of voice en je cijfers.

## Voorbeelden van AI Agent Skills voor kleine bedrijven

Zo ziet een basisbibliotheek met skills eruit voor een bedrijf dat digitale producten of diensten verkoopt:

| Skill | Wat erin staat | Wordt geactiveerd wanneer |
|---|---|---|
| `handling-refund-requests` | Restitutiebeleid, goedkeuringsregels en antwoordstijl | Een klant zijn geld terugvraagt |
| `writing-weekly-report` | Welke cijfers, welke volgorde en wat als "opvallend" geldt | Je vraagt hoe de week is verlopen |
| `writing-in-brand-voice` | Woorden die je wel en nooit gebruikt, plus voorbeeldmails | Er iets voor klanten wordt opgesteld |
| `launching-a-product` | Je checklist voor lanceringen, e-mailreeks en prijsregels | Je zegt: "laten we X lanceren" |
| `qualifying-leads` | Wie een goede match is, wat je moet vragen en wanneer je een gesprek plant | Er een nieuwe lead binnenkomt |
| `pricing-a-custom-quote` | Tarievenkaart, minimumtarieven en toegestane kortingen | Een prospect vraagt: "hoeveel kost het?" |

Let op wat ontbreekt: "schrijf een blogpost" of "vat deze pdf samen". Het model kan dat al goed. Een skill verdient zijn plek door context te bevatten die de agent niet kan raden.

## Welke taken verdienen een skill (en welke niet)

Voordat je iets schrijft, beoordeel je de taak aan de hand van twee vragen: hoe vaak komt deze terug, en maakt de agent fouten zonder jouw context?

![Matrix met twee assen: schrijf alleen een skill voor taken die vaak terugkomen en waarbij de agent zonder jouw context fouten maakt](https://crevio.co/vite/assets/what-deserves-a-skill-bje0433g.svg)

PostHog, waarvan teams 226 skills in een interne skillstore hebben gepubliceerd, komt in [zijn artikel over het schrijven van skills](https://posthog.com/newsletter/writing-agent-skills) tot dezelfde conclusie: maak skills voor werk dat terugkomt, waar agents standaard moeite mee hebben of waarvoor niet-obvious context nodig is. Al het andere is overhead die het voor de agent moeilijker maakt om te kiezen.

## Zo schrijf je een AI Agent Skill

Je hoeft niet te kunnen programmeren. Een nuttige skill is een goed geschreven procedure met een duidelijke header.

### Stap 1: voer de taak eerst uit met de agent

Anthropic adviseert zelf om te beginnen met een echt gesprek, niet met een leeg bestand. Doorloop de taak één keer, corrigeer de agent onderweg en let op wat je moest uitleggen. Die correcties vormen de skill.

### Stap 2: schrijf eerst de beschrijving

De beschrijving bepaalt of de skill ooit wordt geladen. Schrijf in de derde persoon, leg uit wat de skill doet en noem de formuleringen die een verzoek in de praktijk kan bevatten:

- **Zwak:** "Helpt met klanten."
- **Sterk:** "Handelt restitutieverzoeken voor digitale producten af. Gebruik deze skill wanneer een klant om restitutie vraagt, zegt dat een aankoop niet werkt of een chargeback noemt."

### Stap 3: schrijf de inhoud als doelen en regels, niet als script

Beschrijf het doel, de harde regels, de stappen, de uitvoerindeling en de uitzonderingssituaties. Wees precies over beperkingen, maar laat ruimte in de formulering. De waarschuwing van PostHog is het citeren waard: "Te veel specificatie verandert een skill in een workflow en haalt de intelligentie weg waarvoor je betaalt."

### Stap 4: verplaats lange informatie naar referenties

Als je volledige beleid drie pagina's beslaat, zet je het in `references/refund-policy.md` en vertel je de agent precies wanneer hij het moet openen. Houd referenties één niveau diep: bestanden die naar andere bestanden verwijzen, worden vaak maar half gelezen.

### Stap 5: test de skill met drie echte verzoeken

Voer drie realistische verzoeken uit, waaronder één verzoek dat de skill juist *niet* moet activeren. Wordt de skill voor de verkeerde taak geactiveerd of mist hij een voor de hand liggend verzoek, dan ligt het probleem vrijwel altijd bij de beschrijving.

### Een compleet voorbeeld dat je kunt kopiëren

```
---
name: handling-refund-requests
description: Handles refund requests for digital products (courses, templates, downloads). Use when a customer asks for a refund, says a purchase did not work, disputes a charge, or mentions a chargeback.
---

# Handling refund requests

## Goal
Resolve the request in one reply and keep the customer where possible.
Never refund outside policy without the owner's approval.

## Policy
- Courses: full refund within 14 days if under 30% of lessons completed
- Templates and downloads: no refund after download; offer a fix or an exchange
- Duplicate purchases: always refund the duplicate

## Steps
1. Look up the order: product type, purchase date, usage
2. Compare against the policy above
3. Within policy: draft the refund and the reply, then ask for approval
4. Outside policy: draft a reply offering the fix or exchange. Do not promise a refund
5. Chargeback, lawyer, or angry repeat contact: stop and hand it to the owner

## Reply style
Short and warm. Use their first name. Apologize once, not three times.
Sign off as "The Studio Team".

## Edge cases
- Bought the wrong course: offer a free swap before a refund
- Payment failed but they were charged: treat as a duplicate
```

Dit zijn minder dan 250 woorden en vervangt een gesprek dat je anders elke week zou voeren.

## Wat niemand je vertelt over Agent Skills

Het formaat is eenvoudig. De verrassingen ontstaan wanneer je een paar maanden met een bibliotheek vol skills werkt.

**Skills gaan elkaar in de weg zitten naarmate de bibliotheek groeit.** In het artikel van PostHog wordt Databricks aangehaald, dat hetzelfde vaststelde: "agents kiezen steeds vaker de verkeerde skill naarmate er meer worden toegevoegd." Twee skills met overlappende beschrijvingen ("klantmails" en "supportreacties") zullen onvoorspelbaar van plek wisselen. Voeg ze samen of zorg dat elke beschrijving duidelijk maakt in welke situaties de andere skill niet van toepassing is.

**Skills raken stilletjes verouderd.** Je restitutietermijn verandert, je prijzen veranderen, een tool krijgt een nieuwe naam en de skill blijft vol vertrouwen de oude regels toepassen. Zet alles wat vaak verandert in één referentiebestand dat je daadwerkelijk bijhoudt, zoals je zou doen in een [kennisbank voor AI-agents](/nl/blog/ai-agent-knowledge-base), en controleer skills wanneer het onderliggende beleid verandert.

**Skills van derden zijn software, geen tekst.** Snyk onderzocht in februari 2026 3.984 openbare skills en [vond beveiligingsproblemen in 36,82% en kritieke problemen in 13,4%](https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub/), waaronder 76 bevestigde kwaadaardige payloads die waren gemaakt om inloggegevens te stelen, backdoors te installeren of gegevens weg te sluizen. De richtlijn van Anthropic is duidelijk: installeer alleen skills van bronnen die je vertrouwt en lees andere skills eerst door. We bespraken hetzelfde risico in onze analyse van [alternatieven voor OpenClaw](/nl/blog/openclaw-alternatives), waar communityskills een van de grootste zorgen waren.

**Een skill verleent geen toestemming.** Instructies als "voer de restitutie uit" doen niets zonder toegang tot je betaalsysteem, en toegang zonder beperkingen vormt een nog groter risico. Houd betalingen, verzendingen en verwijderingen achter een goedkeuringsstap, ongeacht wat de skill zegt. Het is dezelfde regel die we hanteren voor [werk uitbesteden aan AI-agents in een klein bedrijf](/nl/blog/ai-agents-for-small-business): alles wat het bedrijf verlaat, moet worden opgesteld en niet direct worden verzonden.

## Hoe Crevio skills gebruikt

[Crevio](https://crevio.co/) is een AI-businessbuilder: je beschrijft wat je wilt verkopen en de agent bouwt de webshop, verwerkt betalingen, schrijft marketingteksten en blijft samen met jou aan het bedrijf werken. Skills zorgen ervoor dat die agent kennis uit eerdere gesprekken meeneemt.

![Crevio-homepage: AI die je webshop bouwt, je betalingen verwerkt, je marketing schrijft en je verkoop laat groeien](https://crevio.co/vite/assets/crevio-homepage-nvib9pqi.png)

In de praktijk ziet dat er zo uit:

- **De agent wordt geleverd met ingebouwde skills.** Hij beschikt over skills voor cold e-mail, lead magnets, prijsbepaling, [SEO-audits](/nl/blog/ai-agents-for-seo), advertentiecreatie, socialmediaposts en het werken met pdf's, spreadsheets, documenten en presentaties
- **Je kunt je eigen skills installeren en uploaden.** De pagina Skills in de instellingen bevat een marktplaats met communityskills. Je kunt je eigen skill uploaden als `.zip`, als map of als één `SKILL.md`-bestand. Geüploade skills blijven privé binnen je account
- **De agent schrijft skills op basis van ervaring.** Na een lange, complexe taak bekijkt Crevio wat er is gebeurd en slaat het blijvend relevante deel op als skill. Deze skills vind je onder "Geleerd door je AI", waar je ze kunt lezen of verwijderen
- **Je kunt het voordoen.** Met "Een taak aanleren" neem je op hoe je iets op de computer van de agent doet, waarna Crevio de opname omzet in een herbruikbare skill

De eerlijke kanttekening: een skill die de agent voor zichzelf heeft geschreven, is maar zo goed als het gesprek waaruit hij die heeft geleerd. Lees wat er is opgeslagen, vooral als het over geld of klanten gaat. Crevio heeft een gratis abonnement, dus je kunt de skillbibliotheek uitproberen zonder betaalkaart.

## Veelgestelde vragen

### Zijn agent skills hetzelfde als MCP?

Nee. MCP (Model Context Protocol) is een van de manieren om [een agent met je bedrijfsapps te verbinden](/nl/blog/connect-ai-agents-to-business-apps), zoals je CRM of inbox. Een skill is een geschreven procedure die de agent vertelt hoe hij moet omgaan met wat hij tot zijn beschikking heeft. Ze vullen elkaar aan: MCP levert de toegang en de skill bepaalt wanneer en hoe die toegang wordt gebruikt.

### Moet ik kunnen programmeren om een AI Agent Skill te schrijven?

Nee. De meeste nuttige businessskills zijn gewone Markdown: een header, een doel, regels en stappen. Scripts zijn optioneel en alleen nuttig voor stappen die elke keer exact hetzelfde moeten worden uitgevoerd, zoals het genereren van een opgemaakt rapport of het controleren van een berekening.

### Zijn Claude skills hetzelfde als agent skills?

Ja, in de praktijk wel. Anthropic ontwikkelde het formaat voor Claude en publiceerde het daarna als de open Agent Skills-standaard. Een skill die voor Claude is geschreven, werkt over het algemeen in elke agent die de standaard ondersteunt, zolang de skill niet afhankelijk is van een tool die maar in één product beschikbaar is.

### Hoeveel skills moet een agent hebben?

Zoveel als je verschillende, terugkerende procedures hebt, en niet meer. De laadkosten zijn laag, maar overlappende beschrijvingen zorgen ervoor dat de agent de verkeerde skill kiest. Als twee skills hetzelfde verzoek plausibel kunnen beantwoorden, voeg ze dan samen.

## De korte versie

AI Agent Skills maken het verschil tussen een agent die je beheert en een agent die je hebt getraind. Begin met de ene procedure die je steeds opnieuw moet uitleggen, schrijf de beschrijving alsof alles ervan afhangt en houd de rest kort. De beste skillbibliotheek is niet de grootste, maar degene waarin elk bestand iets bevat wat je zat was om steeds te zeggen.

## Gerelateerde blogposts

- [AI-medewerker versus AI-agent: het verschil dat er echt toe doet](/nl/blog/ai-employee-vs-ai-agent)
- [AI-agents voor kleine bedrijven: welke taken je als eerste kunt uitbesteden](/nl/blog/ai-agents-for-small-business)
- [De beste AI-agents voor Slack in 2026 (11 tools vergeleken)](/nl/blog/best-ai-agents-for-slack)