Wat is een skill en hoe schrijf je een goede?

Een skill is een werkinstructie die Claude zelf erbij pakt

Een skill is een map met één bestand: SKILL.md. Daarin staat in gewone taal hoe je team een klus doet, bijvoorbeeld "zo maken wij een offerte voor een nieuwe klant". Bovenaan staan een naam en een korte beschrijving.

Claude leest bij de start alleen die naam en beschrijving van al je skills. Lijkt je vraag op een beschrijving, dan leest hij de rest van het bestand. Je kunt dus tientallen skills hebben zonder dat Claude trager of slordiger wordt. De beschrijving bepaalt wel of een skill aanslaat, dus daar zit het meeste werk.

In Claude Code staan je eigen skills in ~/.claude/skills, met één map per skill. Ze werken dan in elk project op je laptop. Skills die bij één project horen, zet je in de map .claude/skills van dat project.

Een skill is kennis, een agent voert uit

Een skill vertelt Claude wat hij moet weten: je huisstijl, je controlelijst, hoe jullie offertes opbouwen. Een agent is een hulpje dat zelfstandig een deeltaak uitvoert, terwijl jij doorwerkt. Ze gaan goed samen: een agent kan skills inladen. Onze vuistregel is: kennis die je wilt hergebruiken wordt een skill.

Een goede skill heeft vijf onderdelen

Zo ziet een SKILL.md eruit

Een voorbeeld met verzonnen gegevens. Het stuk tussen de streepjes is de naam en de beschrijving; daaronder staan de regels, het voorbeeld en de grenzen.

---
name: offerte-opmaken
description: Zet een offerte in onze huisstijl op basis van een intakeverslag. Gebruik dit als iemand vraagt om een offerte, prijsopgave of voorstel voor een klant.
---

# Offerte opmaken

## Regels
- Bedragen altijd ex btw, met de btw apart eronder.
- Reiskosten alleen buiten de regio. Staat de plaats er niet in, vraag het.
- Betaaltermijn en geldigheid komen uit voorwaarden.md.

## Voorbeeld
Intake: "Bakkerij De Korrel, 3 workshops, 12 mensen, Utrecht"
Uitkomst: offerte met 3 regels, totaal ex btw, 30 dagen geldig.

## Grenzen
- Verzin geen prijzen. Staat een dienst niet in prijzen.md, meld dat.
- Verstuur niets. Zet de offerte klaar als concept.

Doe de klus eerst drie keer met de hand

Wie op dag één een skill schrijft, schrijft op hoe hij denkt dat het werk gaat. Na drie keer weet je hoe het echt gaat. Anthropic raadt hetzelfde aan: doe de taak eerst zonder skill en let op wat je steeds opnieuw moet uitleggen.

1. Doe de klus met Claude, zonder skill. Leg uit wat je wilt en verbeter wat er misgaat.
2. Herhaal dat met een nieuw geval. Na twee of drie keer zie je welke uitleg steeds terugkomt.
3. Zeg "maak hier een skill van". Claude kent het formaat en schrijft de SKILL.md zelf. Nog beter gaat het met skill-creator, de skill die Anthropic zelf maakte om skills te bouwen. Die stelt de juiste vragen, schrijft de beschrijving en test of de skill aanslaat.
4. Lees hem na en schrap. Haal uitleg weg die Claude al weet. Houd de regels die alleen jouw team kent.
5. Test hem in een nieuw gesprek met een nieuw geval. Slaat hij aan, en klopt de uitkomst? Pas anders de beschrijving of de regels aan.

Eén skill is één klus

Drie kleine skills die je na elkaar gebruikt werken beter dan één skill die alles kan. Die alleskunner wordt onvoorspelbaar, en niemand durft hem nog aan te passen. Bouw dus liever een skill die een factuur leest en een tweede die de boeking voorstelt.

Je bouwt er honderd en je gebruikt er zeven. Dat is geen verspilling: zo vind je de zeven die je werk echt veranderen. Een skill die je na een maand niet gebruikt, gooi je weg.

Deel je skills via een gedeelde map met een snelkoppeling

Werkt je hele team met Claude Code, zet de skills dan in één git-repository met één map per skill. Kloon die niet in de verborgen map ~/.claude, maar op een plek die je ziet, bijvoorbeeld in Documenten. Daar opent iedereen een skill gewoon in zijn editor, ziet wat er nieuw is en past hem aan. Claude Code vindt de skills via een symlink: een snelkoppeling van ~/.claude/skills naar die map.

# macOS
git clone https://github.com/jullie-team/skills.git ~/Documents/skills
ln -s ~/Documents/skills ~/.claude/skills

# Windows (PowerShell)
git clone https://github.com/jullie-team/skills.git $HOME\Documents\skills
New-Item -ItemType Junction -Path $HOME\.claude\skills -Target $HOME\Documents\skills

Op Windows is een junction de snelkoppeling die zonder beheerdersrechten werkt, ook op een laptop die door IT wordt beheerd. Bestaat ~/.claude/skills al, verplaats je eigen skills dan eerst naar de nieuwe map en verwijder de oude map.

Bouwt een collega een nieuwe skill, dan haal je hem op met git pull. Je eigen skill deel je door hem te committen en te pushen.

Werkt je team in de Claude-app, dan upload je een skill als ZIP-bestand. Op een Team- of Enterprise-abonnement kan de beheerder skills voor de hele organisatie klaarzetten.

Stand oktober 2026.