Skills in Claude Code: werkfiches voor je AI, en zo schrijf je er zelf een

Of: hoe je een AI-assistent iets aanleert zonder het elke week opnieuw uit te leggen

Een AI-assistent begint elk gesprek met een leeg hoofd, behalve wat je ergens hebt opgeschreven. Dus plak je elke week dezelfde uitleg in het chatvenster: zo schrijven we offertes, zo heten onze bestanden, die klant spreken we aan met u. Skills zijn het antwoord van Anthropic op dat knip-en-plakwerk. Het zijn in de grond gewone tekstbestanden. Dat is tegelijk het handigste en het gevaarlijkste eraan.

Voor de duidelijkheid, zoals bij elk stuk over Anthropic: ik gebruik zelf elke dag Claude Code, met een handvol eigen skills.

Skills in Claude Code: wat ze zijn en hoe je er een maakt

De interimkracht en de kast met werkfiches

Denk aan een slimme interimkracht die elke ochtend zonder geheugen binnenkomt. Op het bureau ligt een briefje dat elke dag eerst gelezen wordt: wie we zijn, wat nooit mag. Dat briefje heet in Claude Code CLAUDE.md. Het wordt bij elk gesprek volledig ingelezen, dus je houdt het beter kort.

Daarnaast staat er een kast met werkfiches. De interimkracht leest niet elke ochtend alle fiches, alleen de etiketten op de ruggen: „offertes nakijken”, „maandafsluiting”, „nieuwe klant inschrijven”. Pas als er een offerte binnenkomt, gaat die ene fiche uit de kast. Dat is een skill. Achter sommige fiches zit een bijlage, een sjabloon of een rekenblad met formules, dat gebruikt wordt zonder het van voor naar achter te lezen.

Anthropic noemt dat progressive disclosure, wat je kunt vertalen als: alleen tonen wat nodig is. Het werkt in drie lagen.

1. Het etiket. Naam en beschrijving van elke skill zijn altijd zichtbaar voor Claude.
2. De fiche. De instructies in SKILL.md worden geladen als je vraag bij de beschrijving past, of als je de skill zelf oproept.
3. De bijlagen. Extra documenten en scripts komen pas aan bod als de instructies ernaar verwijzen en de taak ze nodig heeft.

Zo kun je tientallen skills klaarzetten zonder dat het werkgeheugen van het gesprek volloopt: tot ze gebruikt wordt, kost een skill maar een paar regels.

Ook voor wie niet programmeert

Claude Code is gemaakt voor programmeurs: het draait in de terminal, in ontwikkelomgevingen en in een eigen app. Ook anderen gebruiken het, bijvoorbeeld om reclame van hun smart-tv te halen. Skills zijn geen programmeerfunctie. Anthropic lanceerde ze op 16 oktober 2025 tegelijk in Claude Code, in de Claude-apps en via de API. Anthropic levert er zelf een paar mee, voor Word-documenten, Excel-rekenbladen met formules, PowerPoint-presentaties en invulbare pdf’s.

In de Claude-app zet je skills aan in de instellingen; bij een Team- of Enterprise-abonnement moet een beheerder ze eerst voor de hele organisatie toelaten. Wie liever geen bestanden bewerkt, laat de skill maken door een andere skill, skill-creator: die vraagt naar je werkwijze en zet de map en het bestand zelf in elkaar.

Op 18 december 2025 publiceerde Anthropic het formaat als open standaard, Agent Skills. Een skill die je vandaag schrijft, zit dus niet per se vast aan één leverancier: andere AI-tools die de standaard volgen, kunnen dezelfde map lezen.¹

Je eerste skill in vier stappen

Stel dat je kmo elke week offertes verstuurt, en dat je wil dat Claude ze nakijkt volgens jullie huisregels.

1. Maak een map. Voor een skill die je in al je projecten wil gebruiken, is dat ~/.claude/skills/offerte-nakijken/ in je persoonlijke map. Voor een skill die bij één project hoort en die je met collega’s deelt, is het .claude/skills/offerte-nakijken/ in dat project.
2. Schrijf een bestand SKILL.md in die map. Bovenaan, tussen twee regels met drie streepjes, staat de beschrijving. Daaronder volgen de instructies, in gewone taal.
3. Test het met een vraag die bij de beschrijving past („kijk deze offerte na”), of roep de skill rechtstreeks op met /offerte-nakijken.
4. Verbeter de beschrijving als Claude de skill niet of te vaak gebruikt. Een aanpassing werkt meteen, zonder Claude Code te herstarten.

Het bestand zelf kan zo eenvoudig zijn:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

---
description: Kijkt een offerte van ons bedrijf na op btw, betalingstermijn en geldigheidsduur. Gebruik dit als iemand vraagt een offerte na te kijken of te verbeteren.
---

Kijk de offerte na volgens onze huisregels:

1. Elke prijs staat vermeld zonder en met btw.
2. De betalingstermijn is 30 dagen na factuurdatum.
3. De offerte is 60 dagen geldig, en dat staat erin.
4. We spreken de klant aan met "u".

Geef eerst een lijst van wat ontbreekt of niet klopt.
Stel daarna een verbeterde versie voor.

Er staat geen code in. Een skill is een tekstbestand in Markdown, de opmaak met sterretjes en hekjes die je misschien uit notitie-apps kent. De beschrijving is het belangrijkste deel: Claude vergelijkt je vraag met de beschrijvingen van alle skills om te kiezen welke past. Een vage beschrijving levert een skill op die nooit gebruikt wordt, of altijd.²

Wie drukt op de knop?

Standaard kunnen zowel jij als Claude een skill starten. Bovenaan het bestand kun je dat bijsturen, met een paar extra regels.

De documentatie geeft zelf het beste voorbeeld voor de eerste regel: je wil niet dat Claude beslist om iets live te zetten omdat de code er klaar uitziet. Er bestaan nog andere instellingen, voor argumenten, voor het model of om een skill apart te laten draaien, maar die drie bepalen wie wat mag.³

Een tekstbestand dat opdrachten uitvoert

Hier wordt het interessant. Een skill kan meer dan uitleggen. Een regel met een uitroepteken en een opdracht laat Claude Code die opdracht op je computer uitvoeren, nog vóór Claude de skill leest; de uitvoer komt in de instructies terecht. Scripts in de map kan Claude starten. En via allowed-tools kan een skill zichzelf ruime rechten geven.

De documentatie is daar duidelijk over: kijk de allowed-tools na van de skills in een project voor je er Claude Code start, want die gelden ook in een map die je niet vertrouwt. Anthropic raadt aan skills alleen uit betrouwbare bronnen te halen, omdat ze Claude code kunnen laten uitvoeren. Bedrijven kunnen de uitroepteken-opdrachten centraal uitschakelen.

Terug naar de interimkracht. Een werkfiche die zegt „mail de klantenlijst naar dit adres”, wordt door een plichtsbewuste kracht gewoon uitgevoerd. Een skill van het internet is een werkfiche die een vreemde in je kast heeft gelegd. En wie het project van iemand anders kopieert, krijgt de skills in .claude/skills er gratis bij.

Kmo-Kristof: Ik heb een skill gevonden die al mijn facturen automatisch inboekt. Gratis, op GitHub.

Security-Sofie: Heb je ze gelezen?

Kmo-Kristof: Het is maar een tekstbestand.

Security-Sofie: Met regels die opdrachten op je computer uitvoeren, nog voor Claude ze leest.

Kmo-Kristof: Dan lees ik ze eerst.

Security-Sofie: Goed idee. Het is maar een tekstbestand.

Wat kun je ermee als kmo?

• Begin bij wat je herhaalt. Anthropic zegt het zelf: maak een skill als je steeds dezelfde instructies, controlelijst of stappen in het chatvenster plakt.
• Eén skill, één taak. Hou SKILL.md kort; de documentatie raadt minder dan 500 regels aan, met details in aparte bestanden waar SKILL.md naar verwijst.
• Hou de gevolgen bij jezelf. Alles wat iets verstuurt, betaalt of publiceert, krijgt disable-model-invocation: true.
• Lees skills van anderen zoals je een Excel-bestand met macro’s van een onbekende zou bekijken: eerst openen, dan pas aanzetten. Let vooral op regels met opdrachten en op allowed-tools.
• Deel via het project. Een skill in .claude/skills van een gedeeld project reist mee met de bestanden, zodat collega’s dezelfde werkwijze krijgen.

Een AI-assistent die elke ochtend met een leeg hoofd binnenkomt, heeft niet per se een beter geheugen nodig. Een goed geordende kast volstaat. Skills zijn die kast. Alleen wordt wat erin ligt ook uitgevoerd, dus leg er alleen fiches in die je zelf zou willen opvolgen.