Een SKILL.md-bestand vormt het hart van elke Claude Skill - een Markdown-bestand dat begint met een korte YAML-header (een name en een description) en wordt gevolgd door de instructies die Claude moet volgen. De beschrijving vertelt Claude wanneer de Skill moet worden gebruikt; de hoofdtekst vertelt hoe.
Op deze pagina
Als je de term hebt gezien en je hebt afgevraagd wat er eigenlijk in staat, volgt hier de anatomie van een SKILL.md, waarom elk onderdeel belangrijk is en hoe je er een schrijft die werkt.
Wat is SKILL.md?
Een Claude Skill is een map en SKILL.md is het vereiste bestand in de hoofdmap. Het is gewone Markdown, dus het kan in elke teksteditor worden geopend. Claude leest het om een vaardigheid te leren - de stappen, regels en best practices voor één type taak. Optionele extra's (sjablonen, scripts, referentiebestanden) kunnen er in dezelfde map naast staan, maar SKILL.md is het ene bestand dat elke Skill moet bevatten.
Wil je een goed afgebakende SKILL.md zien in plaats van er een vanaf nul te bouwen? Yuri's frontmatter en instructies zijn al geschreven en getest om bugs, beveiligingslekken en prestatieproblemen tijdens een review op te sporen.
Bekijk Yuri - Code Reviewer AI Skill →De twee onderdelen van een SKILL.md
1. De frontmatter (metadata)
Helemaal bovenaan staat een klein YAML-blok tussen ----markeringen. Het bevat de essentiële metadata - minimaal een name en een description:
---
name: weekly-report
description: Zet ruwe notities om in ons standaard wekelijkse rapport. Gebruik dit wanneer de gebruiker om een wekelijkse update, statusrapport of een "samenvatting van de week" vraagt.
---Dit blok is bijzonder: wanneer een sessie start, laadt Claude alleen de naam en beschrijving van elke geïnstalleerde Skill vooraf in - niet het hele bestand. Zo blijft het contextvenster licht en daarom doet de beschrijving zoveel zwaar werk.
2. De hoofdtekst (instructies)
Onder de frontmatter schrijf je in normale Markdown wat Claude daadwerkelijk moet doen - idealiter als duidelijke, genummerde stappen met eventuele regels of voorbeelden:
## Stappen
1. Groepeer de notities onder Successen, In uitvoering en Blokkades.
2. Houd elke bullet bij één zin, in de verleden tijd.
3. Sluit af met een samenvatting van één regel met "Volgende week".
4. Verzin nooit statistieken die niet in de notities staan.Waarom de beschrijving de belangrijkste regel is
Activering hangt volledig af van de beschrijving. Terwijl je werkt, vergelijkt Claude je verzoek met de beschrijving van elke skill en laadt het volledige bestand alleen wanneer het overeenkomt. Een vage beschrijving ("helpt met rapporten") wordt zelden geactiveerd. Een specifieke beschrijving ("gebruik deze wanneer de gebruiker om een wekelijkse update of statusrapport vraagt") wordt betrouwbaar geactiveerd. Als je één regel onthoudt, laat het dan deze zijn: schrijf de beschrijving voor wanneer je de skill moet gebruiken, niet alleen voor wat de skill is.
Hoe Claude het bestand gebruikt
- Bij het opstarten: Claude leest de naam en beschrijving van elke skill.
-
Tijdens de taak: als je verzoek overeenkomt met een beschrijving, laadt Claude de volledige
SKILL.mdvan die skill (en alle bijgevoegde bronnen). - Daarna: Claude volgt de instructies in de hoofdtekst om het werk uit te voeren.
Deze aanpak van "alleen laden wanneer nodig" heet progressieve onthulling. Hierdoor kun je veel skills geïnstalleerd houden zonder de context van het model onnodig uit te breiden.
Een goede SKILL.md schrijven
- Maak de beschrijving glashelder. Geef duidelijk aan wanneer de skill moet worden geactiveerd.
- Houd de eerste versie klein. Vijf tot tien duidelijke regels zijn beter dan een omvangrijk document.
- Wees concreet. Gebruik genummerde stappen, expliciete regels en een kort voorbeeld.
- Test met echte taken. Breid alleen uit waar Claude tekortschiet.
Moet je er zelf een schrijven?
Nee. Zelf een skill schrijven is geweldig voor workflows die uniek zijn voor jou, maar als je gewoon het resultaat wilt, worden kant-en-klare skills geleverd met een al geschreven en geteste SKILL.md. Bekijk de KissMySkills-bibliotheek met meer dan 1.000 skills, promptpakketten en agents, of de collectie Claude Code-skills. Wil je er eerst een in actie zien? Probeer een gratis generator of haal een gratis skill.
Niet elke SKILL.md is voor programmeurs - Ryans frontmatter en instructies zijn geschreven voor bestuursstukken, memo's voor alle medewerkers en briefings voor leidinggevenden; bewerken is niet nodig.
Bekijk Ryan - Chief of Staff AI Skill →Veelgestelde vragen
Is SKILL.md gewoon Markdown?
Ja - het is een standaard Markdown-bestand met bovenaan een YAML-frontmatter-blok. Het kan in elke teksteditor worden geopend; speciale software is niet nodig.
Wat is vereist in een SKILL.md?
Minimaal een frontmatter-blok met een naam en een beschrijving. De inhoud met instructies maakt de Skill nuttig, maar de metadata zorgt ervoor dat deze vindbaar en activeerbaar is.
Waar moet het SKILL.md-bestand staan?
In de hoofdmap van de Skill-map. In Claude Code staan Skills in ~/.claude/skills/<name>/ voor persoonlijk gebruik of .claude/skills/<name>/ binnen een project, met de SKILL.md in de hoofdmap van de map.
Kan ik de inhoud van een SKILL.md gebruiken in ChatGPT of Gemini?
Ja. De instructies zijn overdraagbaar - plak de inhoud in de aangepaste instructies van ChatGPT of Gemini voor hetzelfde gedrag. Automatisch activeren via frontmatter is een functie van Claude.
Samengevat:
Als je liever zelf geen YAML-frontmatter schrijft, is Yuri - Code Reviewer een uitstekende keuze voor ontwikkelaars, en Ryan - Chief of Staff is gericht op teksten voor leidinggevenden en zakelijke communicatie. Alles werkt in Claude, ChatGPT en elke AI-chat zonder codering en met een 30 dagen niet-goed-geld-teruggarantie.
Begin met een werkend voorbeeld
De snelste manier om SKILL.md te begrijpen, is er een goede te lezen. Pak een gratis Skill, open het bestand en bekijk de structuur met frontmatter en stappen in actie - lees daarna in drie minuten hoe je deze installeert.