Een werkwijze die pas laadt als je hem nodig hebt
De vraag achter skills is meestal deze: je CLAUDE.md groeit, want elke werkwijze die het team een keer heeft uitgelegd komt erbij. Hoe je een release maakt, hoe een PR-review gaat, wat je doet bij een storing. Maar CLAUDE.md wordt in elke sessie geladen, ook als je een typfout repareert. De kostenpagina van Claude Code raadt aan CLAUDE.md onder de 200 regels te houden en zulke werkwijzen naar skills te verhuizen.
Een skill kost bijna niets zolang hij niet gebruikt wordt. Claude ziet alleen de naam en de beschrijving. Pas als een taak erbij past, of als jij /naam typt, leest Claude het hele bestand.
Hoe een skill eruitziet
Een skill is een map met één verplicht bestand: SKILL.md. Bovenaan staat YAML tussen twee regels ---, daaronder gewone instructies.
---
name: release
description: Maakt een release volgens onze stappen. Gebruik bij een nieuwe versie of tag.
disable-model-invocation: true
---
1. Draai de tests.
2. Werk CHANGELOG.md bij.
3. Maak de tag en push hem.
De description is het belangrijkste veld: daarop beslist Claude of de skill past. Zet de belangrijkste toepassing vooraan, want beschrijving en when_to_use samen worden in het overzicht na 1.536 tekens afgekapt. name wordt het commando en is standaard de naam van de map.
Andere velden die je in de praktijk gebruikt:
| Veld | Wat het doet |
|---|---|
disable-model-invocation: true |
Alleen jij start de skill. Claude doet het nooit op eigen houtje. |
user-invocable: false |
Niet in het /-menu; alleen Claude gebruikt hem, als achtergrondkennis. |
allowed-tools |
Tools die Claude zonder toestemmingsvraag mag gebruiken in de beurt waarin de skill start. |
context: fork |
De skill draait als subagent, met een eigen context. |
$ARGUMENTS |
Invoer meegeven, zoals in /fix-issue 123. |
Naast SKILL.md kun je bestanden zetten, zoals reference.md of een map scripts/. Claude opent die alleen als het nodig is; scripts worden uitgevoerd, niet in de context geladen. De documentatie raadt aan SKILL.md zelf onder de 500 regels te houden. Een regel als !`git diff HEAD` draait een commando voordat de skill verstuurd wordt en zet de uitvoer op die plek.
Waar skills staan
- Persoonlijk:
~/.claude/skills/<naam>/SKILL.md. Voor jou, in al je projecten. - Project:
.claude/skills/<naam>/SKILL.mdin de repo. Commit hem en iedereen die de repo binnenhaalt heeft hem. - Plugin:
<plugin>/skills/<naam>/SKILL.md. Beschikbaar als/plugin-naam:skill-naamwaar de plugin aanstaat. - Organisatie: in de map van de beheerde instellingen. IT rolt hem uit naar iedereen.
Bij dezelfde naam wint organisatie van persoonlijk en persoonlijk van project. Plugin-skills hebben hun eigen naamruimte.
Skill, CLAUDE.md, slash command of subagent?
| Gebruik | Voor |
|---|---|
| CLAUDE.md | Wat bij bijna elke taak hoort, en wat Claude niet zelf uit de repo haalt |
| Skill | Een werkwijze of teamkennis die alleen bij sommige taken nodig is |
| Slash command | Bestaat nog als naam, maar is nu een skill die jij start |
| Subagent | Een aparte werker met eigen context en eigen toolrechten, in .claude/agents/ |
Het verschil met een subagent zit in de context. Een skill draait in jouw gesprek, tenzij je context: fork zet. Een subagent begint schoon en geeft alleen zijn resultaat terug. Ze werken ook samen: een subagent kan via het veld skills een skill vooraf laden. Meer in wat subagents zijn.
Het misverstand: een skill is een regel
Een skill die Claude zelf oppakt, is een instructie die het model leest en afweegt, net als je prompt en CLAUDE.md. De best practices van Claude Code zetten hem daarom bij wat Claude beslist, niet bij wat Claude Code afdwingt. Wat wel vastligt: welke skills alleen jij mag starten. Moet iets altijd of nooit gebeuren, gebruik dan een hook of een deny-regel.
Wat dit betekent voor een team
Skills zijn een van de makkelijkste manieren om werkwijzen te delen: een map in git, en elke ontwikkelaar die de repo kloont heeft dezelfde /release. Voor skills die over meerdere repo’s gaan bundel je ze in een plugin. Beheerders kunnen met de instelling skillOverrides een skill aan, uit of alleen op naam zetten zonder het bestand te openen. Zie ook hoe je context deelt met je team.
Wat een skill niet doet, is leren. Hij bevat wat iemand erin schreef. Claude Code kan een correctie van je collega daarnaast bewaren in auto memory, maar dat geheugen staat op de computer van die collega: het wordt niet gedeeld met het team of met andere AI-tools tot iemand het in de skill zet. En de skill werkt in Claude Code en tools die Agent Skills lezen, niet vanzelf in ChatGPT of Copilot. Zie ook hoe het geheugen van Claude Code werkt.
Waar Bombos past
Skills zijn een goede plek voor werkwijzen die al zijn opgeschreven. Bombos is een plugin die Claude Code en de andere AI-tools van het team, zoals ChatGPT, Copilot, Codex en Cursor, één gedeeld geheugen geeft: teamkennis, regels die geleerd zijn uit correcties, en wat al in mail, documenten en repo’s staat, terug te volgen naar de bron. Eén ontwikkelaar kan het eerst zelf proberen op zijn eigen agents.
Vragen die hierbij horen
Wat is er met de eigen slash commands gebeurd?
Die zijn opgegaan in skills. Bestanden in .claude/commands/ blijven werken, en een skill met dezelfde naam gaat voor. Zet je deploy.md om naar .claude/skills/deploy/SKILL.md, dan typ je nog steeds /deploy en kun je er bestanden bij zetten.
Hoe voorkom ik dat Claude een skill zelf start?
Zet disable-model-invocation: true in de kop. De skill draait dan alleen als jij hem aanroept. Doe dat bij alles wat iets in gang zet, zoals een release of een deploy.
Hoe zie ik welke skills er geladen zijn?
Typ /skills. Het /-menu toont ze ook op naam. Een wijziging in een bestaande skill werkt meteen, zonder Claude Code te herstarten.
Werken skills ook buiten Claude Code?
Skills volgen de open standaard Agent Skills. Je kunt ze ook uploaden in claude.ai of gebruiken via de Skills API, maar daar zijn alleen de velden name, description, license, compatibility, metadata en allowed-tools toegestaan.
