SKILL.md

Een SKILL.md is een markdownbestand dat dient als de fundamentele eenheid voor een Claude Code skill. Het bestaat uit twee afzonderlijke delen: YAML frontmatter ingesloten tussen --- markeringen, en markdown inhoud die de instructies bevat die Claude volgt wanneer de skill wordt uitgevoerd.

Het SKILL.md bestand bevindt zich binnen een specifieke mapstructuur. Voor persoonlijke skills die beschikbaar zijn in al uw projecten, bevindt het zich op ~/.claude/skills/<skill-name>/SKILL.md. Voor projectspecifieke skills is het pad .claude/skills/<skill-name>/SKILL.md. Als de skill deel uitmaakt van een plugin, wordt deze gevonden op <plugin>/skills/<skill-name>/SKILL.md.

De mapnaam die het SKILL.md bestand bevat, bepaalt het commando dat u gebruikt om de skill aan te roepen via een slash-commando (bijv. /skill-name). Het name veld binnen de YAML frontmatter stelt echter het weergavelabel in dat verschijnt in de skill-lijsten. Een uitzondering doet zich voor bij plugin-root SKILL.md bestanden, waarbij het name veld direct de commandonaam bepaalt, aangezien er geen speciale skillmap is om deze van af te leiden.

Naast het SKILL.md bestand zelf, kan de skillmap aanvullende bestanden bevatten, zoals referentiedocumentatie of scripts. Deze aanvullende bestanden worden pas door Claude Code geladen wanneer ze nodig zijn tijdens de werking van de skill. Claude Code bewaakt actief deze skillmappen. Als gevolg hiervan worden wijzigingen in een SKILL.md bestand of de toevoeging van nieuwe bestanden van kracht binnen de huidige sessie zonder dat een herstart nodig is. Het aanmaken van een top-level skillsmap die niet bestond aan het begin van de sessie, vereist echter een herstart om Claude Code deze te laten herkennen.

Claude Code skills volgen de Agent Skills open standaard, wat interoperabiliteit en een consistente aanpak voor skillontwikkeling bevordert. Raadpleeg Authoring Skills voor richtlijnen over het maken van goed gestructureerde skillbestanden.