Agent Skills
SKILL.md
Simpele Uitleg
Agent Skills zijn herbruikbare opdrachten die je aan Claude Code toevoegt via SKILL.md-bestanden. Je maakt een skill één keer — bijvoorbeeld "review deze pull request" of "schrijf een commit message" — en roept het daarna op met een slash-commando als /review of /commit. Het is alsof je een AI-agent vaste taken aanleert die het steeds opnieuw kan uitvoeren.
Technische Definitie
Skills zijn SKILL.md-bestanden met YAML-frontmatter en Markdown-instructies. Ze worden opgeslagen in .claude/skills/ (project) of ~/.claude/skills/ (persoonlijk). Claude Code laadt bij het opstarten alleen de beschrijvingen — de volledige inhoud wordt pas geladen bij aanroep. Skills ondersteunen $ARGUMENTS-substitutie, dynamische context via !command-syntax, en kunnen via context: fork in een geïsoleerde subagent draaien. De standaard volgt het Agent Skills-formaat.
Waarom Dit Belangrijk Is
Zonder skills herhaal je dezelfde instructies elke keer: "Review deze code, let op TypeScript-fouten, check de imports, test of het bouwt." Met een skill typ je /review en Claude Code voert het complete proces uit volgens jouw specificaties.
Dat is niet alleen sneller — het is ook consistenter. Elke review volgt dezelfde checklist. Elke commit message heeft hetzelfde format. Elk nieuw component wordt op dezelfde manier aangemaakt.
Voor development teams zijn skills de manier om best practices in te bakken in de tooling. Niet als documentatie die niemand leest, maar als uitvoerbare prompts die het team dagelijks gebruikt. In de Claude Code Masterclass leer je hoe je effectieve skills bouwt.
Hoe Het Werkt
Je maakt een map aan in .claude/skills/ met de naam van je skill, en plaatst daar een SKILL.md-bestand in. In de YAML-header beschrijf je wat de skill doet, en in de body schrijf je de instructies die Claude Code moet volgen.
Bijvoorbeeld: een skill voor code reviews. Je maakt .claude/skills/review/SKILL.md met instructies als "Analyseer de gewijzigde bestanden, check op TypeScript-fouten, verifieer dat tests aanwezig zijn, en geef feedback." Daarna typ je /review en Claude voert het allemaal uit.
Skills kunnen zowel door jou (via /) als automatisch door Claude worden aangeroepen. Met disable-model-invocation: true beperk je het tot handmatige aanroep. Met user-invocable: false laat je alleen Claude beslissen wanneer de skill relevant is.
Je kunt skills delen via git (.claude/skills/) of persoonlijk houden (~/.claude/skills/). Teams delen hun skills zodat iedereen dezelfde workflows gebruikt. Meer leren? AI als Teamsport behandelt precies dit.
Use Cases
Gestandaardiseerde code reviews
Een /review-skill die automatisch gewijzigde bestanden analyseert, checkt op TypeScript-fouten, imports verifieert, en een samenvatting geeft. Elk teamlid krijgt dezelfde reviewkwaliteit, ongeacht ervaring.
Consistente commit messages
Een /commit-skill die de staged changes analyseert, de juiste commit message schrijft volgens de projectconventies, en de commit uitvoert. Nooit meer discussie over commit-format.
Component-generatie
Een /component-skill die een nieuw React-component aanmaakt volgens de teamstandaarden: TypeScript, Tailwind, tests, en de juiste mapstructuur. Elk component begint op dezelfde manier.
Team-breed herbruikbare workflows
Skills in .claude/skills/ worden via git gedeeld met het hele development team. Iedereen gebruikt dezelfde /review, /test en /deploy workflows. In AI als Teamsport leer je hoe je dit organiseert.
Voorbeelden
Skill vs. elke keer uitleggen
Met skill: typ /review. Klaar. Dezelfde instructies, maar dan opgeslagen en herbruikbaar. De skill bevat alle details, jij hoeft ze nooit meer te herhalen.
Persoonlijk vs. gedeeld
Veelgemaakte Fouten
"Ik schrijf voor elke taak een nieuwe skill"
Skills zijn voor herbruikbare workflows, niet voor eenmalige taken. Als je iets maar één keer doet, is een gewone prompt sneller. Skills lonen pas als je dezelfde workflow regelmatig herhaalt.
"Mijn skill moet zo gedetailleerd mogelijk zijn"
Te veel detail in een skill beperkt de flexibiliteit. Beschrijf het doel en de constraints, maar laat Claude Code het denkwerk doen. "Review op TypeScript-fouten en missende tests" is beter dan stap-voor-stap elke actie voorschrijven.
"Skills zijn alleen voor developers"
Skills werken voor elke herbruikbare AI-workflow. Een /briefing-skill voor marketing, een /analyse-skill voor finance — de mogelijkheden gaan verder dan code. Het principe is hetzelfde: eenmalig opzetten, steeds hergebruiken.
Tools Die Dit Gebruiken
Veelgestelde Vragen
Hoe maak ik een skill aan?
Wat is het verschil tussen skills en CLAUDE.md?
Kan Claude zelf beslissen om een skill te gebruiken?
Werken skills ook in andere AI-tools dan Claude Code?
Gerelateerde Termen
Wil je deze term in de praktijk leren toepassen?