Claude Code skills maken: uitleg en voorbeeld
In het kort
Een skill is een map met een SKILL.md-bestand waarin je een werkwijze vastlegt. Claude Code gebruikt de skill zelf wanneer de omschrijving past bij je vraag, of jij roept hem aan met /naam. Persoonlijke skills zet je in ~/.claude/skills/<naam>/, skills voor één project in .claude/skills/<naam>/. Alleen het veld description wordt aangeraden, alle andere velden zijn optioneel.
Wat is een skill?
Een skill is een vastgelegde werkwijze. Je schrijft in gewone taal hoe een taak moet, en Claude Code voert die taak daarna steeds op die manier uit. Denk aan een vaste opzet voor een offerte, een controlelijst voor een code review of de stappen om een website live te zetten.
Het verschil met CLAUDE.md: CLAUDE.md laadt in elke sessie, een skill pas wanneer hij nodig is. Daarom horen stappenplannen in een skill.
Waar zet je een skill?
| Soort | Locatie | Werkt in |
|---|---|---|
| Persoonlijk | ~/.claude/skills/<naam>/SKILL.md | Al je projecten op deze computer |
| Project | .claude/skills/<naam>/SKILL.md | Dit project, te delen via git |
| Plugin | <plugin>/skills/<naam>/SKILL.md | Overal waar de plugin aan staat, als /plugin-naam:skill-naam |
Een skill maken
- Maak een map, bijvoorbeeld
~/.claude/skills/wijzigingen-samenvatten/. - Maak daarin een bestand
SKILL.mdmet bovenaan de frontmatter en daaronder de instructies. - Roep de skill aan met
/wijzigingen-samenvatten, of stel een vraag die past bij de omschrijving, zoals "wat heb ik veranderd?".
Voorbeeld
Deze skill is een vertaalde versie van het voorbeeld uit de officiële documentatie:
---
description: Vat niet-vastgelegde wijzigingen samen en noemt risico's. Gebruik dit als de gebruiker vraagt wat er veranderd is of om een commit-bericht vraagt.
---
## Huidige wijzigingen
!`git diff HEAD`
## Instructies
Vat de wijzigingen hierboven samen in twee of drie punten. Noem daarna risico's, zoals ontbrekende foutafhandeling of tests die moeten worden bijgewerkt. Is de diff leeg, meld dan dat er geen wijzigingen zijn.De regel met !`git diff HEAD` voert een commando uit voordat Claude de skill leest. Claude krijgt dus de echte wijzigingen te zien.
Hoe bepaalt Claude Code wanneer het een skill gebruikt?
Op basis van het veld description. Schrijf daarin wat de skill doet en wanneer hij gebruikt moet worden, met de woorden die je zelf in een vraag zou typen. Ontbreekt de description, dan gebruikt Claude Code de eerste regel van de tekst. De description en het optionele veld when_to_use worden samen na 1.536 tekens afgekapt.
Velden die je kunt instellen
name: de naam van het commando. Standaard is dat de naam van de map.disable-model-invocation: true: alleen jij kunt de skill starten, Claude Code doet het niet zelf.user-invocable: false: de skill staat niet in het /-menu en alleen Claude gebruikt hem.allowed-tools: tools die de skill zonder extra toestemming mag gebruiken.context: fork: de skill draait in een aparte subagent.
Extra bestanden
Een skill-map mag meer bestanden bevatten, zoals een referentiedocument, voorbeelden of een script. Verwijs ernaar vanuit SKILL.md. Claude leest ze alleen als dat nodig is, zodat SKILL.md kort blijft.
Skills of CLAUDE.md?
Vaste feiten die in elke sessie gelden, horen in CLAUDE.md. Hoe je die goed opzet, lees je in Een goede CLAUDE.md schrijven. Wil je je eigen skills samen opzetten, plan dan een 1-op-1 Claude Code-coachsessie.
Veelgestelde vragen
Wat is het verschil tussen een skill en CLAUDE.md?
CLAUDE.md laadt in elke sessie en is bedoeld voor vaste feiten en regels. Een skill laadt pas wanneer je hem aanroept of wanneer Claude Code hem relevant vindt, en is bedoeld voor werkwijzen en stappenplannen.
Kan ik een skill delen met mijn team?
Ja. Zet hem in de map .claude/skills/ van je project en deel hem via git, of verpak hem in een plugin.
Bronnen
Geraadpleegd op 2 oktober 2026.