Claude Code Skills zijn mappen met een SKILL.md-bestand dat Claude Code op aanvraag laadt wanneer een taak overeenkomt met de beschrijving van de Skill. Je plaatst de map in .claude/skills/ in je project (of ~/.claude/skills/ voor elk project), Claude Code leest de frontmatter en haalt vanaf dat moment de instructies op wanneer ze relevant zijn. Hieronder: waar ze staan, hoe ze verschillen van CLAUDE.md, slashopdrachten en MCP, een installatie in 3 stappen en 15 ontwikkelaars-Skills die vandaag in Claude Code werken.
Wat een Claude Code Skill daadwerkelijk is
Een Skill is een map met één vereist bestand, SKILL.md, en optioneel een paar ondersteunende bestanden (referentiedocumenten, sjablonen, kleine scripts). De SKILL.md begint met YAML-frontmatter met twee velden waar Claude Code op let: naam en beschrijving. Onder de frontmatter staat gewone Markdown: de rol, het proces, het uitvoerformaat, de regels.
De belangrijke ontwerpbeslissing is dat Skills lui worden geladen. Claude Code houdt in de context een korte index bij van de naam en beschrijving van elke geïnstalleerde Skill. Wanneer je verzoek eruitziet als een match, leest het de volledige SKILL.md en volgt het die. Wanneer er geen match is, kost de Skill je vrijwel niets. Daarom is een goed geschreven beschrijving belangrijker dan al het andere in het bestand: het is het enige wat Claude Code ziet voordat het beslist of het de Skill moet openen.
Dezelfde SKILL.md krijg je wanneer je een Skill koopt op KissMySkills: een .md-bestand plus een README, identiek aan wat je naar een Claude Project, een aangepaste GPT of een Gemini Gem zou uploaden.
Waar Skills staan: projectniveau versus gebruikersniveau
Claude Code kijkt op twee plaatsen.
-
Projectniveau:
<repo>/.claude/skills/<skill-name>/SKILL.md. Commit deze map en elk teamlid dat de repo clonet, krijgt de Skill. Gebruik dit voor alles wat met deze codebase te maken heeft: je checklist voor codebeoordelingen, je deployment-runbook, je stijl voor API-documentatie. -
Gebruikersniveau:
~/.claude/skills/<skill-name>/SKILL.md. Beschikbaar in elk project op je computer, onzichtbaar voor teamleden. Gebruik dit voor persoonlijke gewoonten: hoe je commitberichten geschreven wilt hebben, je voorkeur voor teststructuur, een persona die je bij verschillende klanten gebruikt.
Als op beide plaatsen een skill met dezelfde naam bestaat, heeft de kopie op projectniveau voorrang. Houd algemene ontwikkelaars-skills op gebruikersniveau en alles met projectspecifieke regels op projectniveau.
Hoe Claude Code een skill ontdekt
Ontdekking wordt aangestuurd door het beschrijving het veld in de frontmatter, niet de bestandsnaam en niet de mapnaam. Een beschrijving als "Code review voor pull requests" is zwak, omdat die alleen wordt geactiveerd wanneer je letterlijk "review" zegt. Een beschrijving als "Beoordeel diffs, pull requests en gewijzigde bestanden op bugs, beveiligingsproblemen, ontbrekende tests en onduidelijke naamgeving. Gebruik dit wanneer de gebruiker vraagt om code te controleren, te reviewen, te auditen of te bekritiseren" wordt geactiveerd door de formuleringen die ontwikkelaars daadwerkelijk gebruiken.
Drie dingen om te weten:
- Skills worden geïndexeerd wanneer een sessie start. Als je halverwege een sessie een map toevoegt, start dan een nieuwe sessie of vraag Claude Code om zijn skills opnieuw te lezen.
- In de beschrijving moet staan wanneer je de skill moet gebruiken, niet alleen wat hij is. Zet triggerzinnen erin.
- Je kunt een skill altijd forceren door hem te noemen: "gebruik de code-reviewer-skill voor deze diff". Automatische ontdekking is een gemak, niet de enige manier.
Skills versus CLAUDE.md versus slashopdrachten versus MCP-servers
Deze vier worden voortdurend door elkaar gehaald, terwijl ze verschillende problemen oplossen.
| Mechanisme | Wat het is | Wanneer het wordt geladen | Het meest geschikt voor |
|---|---|---|---|
| CLAUDE.md | Projectgeheugenbestand in de hoofdmap van de repository (of ~/.claude/CLAUDE.md) | Altijd, elke beurt | Feiten die Claude nooit mag vergeten: stack, conventies, opdrachten, gebieden waar je niet mag komen |
| Skill | Map met SKILL.md en optionele ondersteuningsbestanden | Op aanvraag, wanneer de beschrijving overeenkomt | Deskundige procedures die je soms nodig hebt: reviews, audits, testplannen, runbooks |
| Slashopdracht | Markdown-bestand in .claude/commands/, uitvoeren met /name | Alleen wanneer je de opdracht typt | Herhaalbare acties die je bewust activeert: /deploy-checklist, /write-pr |
| MCP-server | Extern proces dat tools beschikbaar stelt (databases, API's, browsers) | Tools zijn gedurende de hele sessie beschikbaar | Claude de mogelijkheid geven om iets te doen, niet de kennis om het goed te doen |
De korte versie: CLAUDE.md is altijd aanwezige context, een skill is expertise die beschikbaar komt wanneer dat nodig is, een slashopdracht is een knop die je indrukt en een MCP-server is een paar handen. Een goede opzet gebruikt ze alle vier: MCP zodat Claude kan handelen, en een skill zodat het handelt als een senior engineer.
Eén gevolg: plak geen checklist van 2.000 woorden voor codebeoordelingen in CLAUDE.md. Die staat in de context wanneer je een variabele hernoemt. Maak er een skill van.
Installeer een Claude Code-skill in 3 stappen
Stap 1: Verkrijg de SKILL.md. Download het .md-bestand uit je KissMySkills-bestelling (of schrijf er zelf een). Als het bestand niet al SKILL.md heet, hernoem het dan. De frontmatter moet minstens name: en description: bevatten; elke skill die op de marketplace wordt verkocht, wordt met beide geleverd.
Stap 2: Maak de map aan. Voer dit uit vanuit de hoofdmap van je repository:
mkdir -p .claude/skills/code-reviewer
mv ~/Downloads/yuri-code-reviewer.md .claude/skills/code-reviewer/SKILL.mdVoor een installatie op gebruikersniveau vervang je .claude/skills voor ~/.claude/skills. De mapnaam moet overeenkomen met het naam veld in de frontmatter, in kleine letters met koppeltekens.
Stap 3: Start een nieuwe Claude Code-sessie in die map en vraag om iets dat door de beschrijving wordt gedekt. Je zou de structuur van de skill in het antwoord moeten zien (de beoordelingssecties, de ernstlabels, wat de skill ook definieert). Geen configuratiebestand en niets anders om opnieuw te starten.
Als je de uitgebreidere uitleg met schermafbeeldingen en het equivalent voor Claude.ai wilt lezen, bekijk dan hoe je een Claude-skill installeert.
Een skill testen
Testen duurt vijf minuten.
- Triggertest. Doe drie verzoeken waarop de skill zou moeten reageren, met verschillende formuleringen ("beoordeel dit", "is er iets mis met deze functie?", "controleer de PR"). Als een ervan niet werkt, breid de beschrijving uit met die formulering.
- Negatieve test. Vraag iets aangrenzends waarop de skill niet zou moeten reageren ("hernoem deze variabele"). Als de skill toch wordt geladen, is de beschrijving te breed.
- Outputtest. Vergelijk het antwoord met wat de SKILL.md belooft. Als de skill zegt "vermeld altijd de ernst per bevinding" en de uitvoer geen ernstniveaus bevat, worden de instructies wel gelezen maar niet opgevolgd; maak ze korter en scherper.
- Expliciete test. Noem de skill rechtstreeks. Als dat werkt en automatische ontdekking niet, ligt het probleem voor 100 procent bij de beschrijving.
Als je wilt zien hoe een goed opgebouwde SKILL.md eruitziet voordat je er een schrijft of koopt, worden hier 12 echte SKILL.md-bestanden regel voor regel uitgelegd.
15 Claude Code-skills voor ontwikkelaars
Alles hieronder komt uit de Claude Code-skillscollectie. Elk item is een eenmalige aankoop: een .md-skillbestand plus README, en valt onder het 30 dagen-geldterugbeleid. De prijzen zijn correct op het moment van schrijven.
Codekwaliteit
Yuri - Code Reviewer AI Skill ($19): Voert een gestructureerde review uit op elke diff, elk bestand of elke PR, met bevindingen gegroepeerd op ernst.
Soren - Code Auditor AI Skill ($19): Controleert een volledige codebase in plaats van één wijziging en zoekt naar structurele schuld, dode code, inconsistente patronen en risicovolle plekken. Goed voor de eerste week in een overgenomen repository.
Albert - AI Code Review agent ($39): Een review-agent die is afgestemd op een snelle iteratie, met focus op correctheid en randgevallen in de gewijzigde regels.
Mira - QA Engineer AI Skill ($19): Zet een functiebeschrijving of diff om in testgevallen, randgevallen en een testplan en schrijft vervolgens de tests in jouw framework. Handig wanneer je Claude Code vraagt om "tests toe te voegen" en meer wilt dan alleen het standaardpad.
Oplevering
Rami - DevOps Engineer AI Skill ($19): CI/CD-pipelines, Dockerfiles, infrastructuur als code en draaiboeken voor incidenten, met de voorzichtigheid die een echte DevOps-engineer meebrengt. Vraagt naar terugdraaien voordat er een deploystap wordt geschreven.
Max - Full Stack Developer AI Skill ($19): De generalist: bouwt functies op voor API, datalaag en UI en houdt de onderdelen consistent. Als je maar één Skill voor oplevering installeert, is dit degene.
Lena - Frontend Developer AI Skill ($19): Componentstructuur, status, toegankelijkheid en responsief gedrag voor moderne frontendstacks. Voorkomt dat Claude Code een soep van div-elementen met inline stijlen oplevert.
Niko - Backend Developer AI Skill ($19): API-ontwerp, datamodellering, foutafhandeling en prestaties voor servercode. Sterk in de saaie onderdelen (validatie, paginering, idempotentie) die generieke prompts overslaan.
Elena - AI Skill voor data-engineers ($19): Pipelines, schema's, transformaties en controles voor datakwaliteit. Gebruik deze wanneer de taak draait om het verplaatsen van data in plaats van het aanbieden ervan.
Documentatie en proces
Saoirse - AI Skill voor technisch schrijvers ($19): README's, PR-beschrijvingen, changelogs, architectuurnotities en onboardingdocumentatie in een consistente stijl. Vraag Claude Code om "de PR-beschrijving te schrijven" als deze Skill is geïnstalleerd, en je krijgt context, wijzigingen, tests en risico's, geen one-liner.
Dorian - AI API-documentatieagent ($39): Genereert en onderhoudt API-referentiedocumentatie op basis van de code: endpoints, parameters, voorbeelden en foutmeldingen. Geef de agent een routerbestand en laat hem de hiaten aanvullen.
Verity - AI Skill voor Release Engineering & Build Systems Engineers ($19): Versiebeheer, releasenotities, conventies voor commitberichten, buildconfiguratie en reproduceerbaarheid. De Skill die je moet installeren als je team ruzie maakt over Conventional Commits.
Beveiliging
Anaya - AI Skill voor applicatiebeveiligingsengineers ($19): Controleert code op injecties, authenticatiefouten, de omgang met secrets en risico's van dependencies, en legt de oplossing uit in plaats van alleen de bevinding te melden. Voer deze uit vóór een release, niet erna.
Selwyn - Claude Skill voor penetratietesters ($19): Denkt als een aanvaller die je eigen applicatie aanvalt: dreigingsmodellen, aanvalspaden en een geprioriteerde lijst van wat je moet testen.
Cassandra - Claude Skill voor Vulnerability Management Engineers ($19): Triage van scannerresultaten en CVE-lijsten: wat belangrijk is, wat ruis is en wat je als eerste moet patchen. Combineer deze Skill met een dependency-audit in je CI.
Weet je niet waarmee je moet beginnen? Op de marktplaats voor Claude Skills staat de hele catalogus per rol gegroepeerd, en de Claude Code-collectie is de selectie voor ontwikkelaars.
Veelgestelde vragen
Waar staat de Claude Code-Skills-map?
Skills op projectniveau staan in .claude/skills/<name>/SKILL.md in je repository. Skills op gebruikersniveau staan in ~/.claude/skills/<name>/SKILL.md in je persoonlijke map en gelden voor elk project.
Werken Claude Code-Skills in ChatGPT?
Het .md-bestand wel, de automatische ontdekking niet. Je kunt dezelfde SKILL.md als instructies voor een aangepaste GPT plakken of uploaden en die werkt dan op dezelfde manier. Wat ChatGPT niet heeft, is de mapconventie en het op beschrijving gebaseerde laden. Daarom activeer je deze via die GPT, in plaats van dat Claude Code bepaalt dat de Skill relevant is.
Wat is het verschil tussen een Claude Code-Skill en CLAUDE.md?
CLAUDE.md wordt bij elke beurt geladen en moet korte, permanente feiten over het project bevatten. Een Skill wordt alleen geladen wanneer de beschrijving overeenkomt met de taak en kan zo lang zijn als de procedure vereist. Lange checklists horen in Skills, niet in CLAUDE.md.
Kan ik meer dan één Skill tegelijk installeren?
Ja. Elke Skill staat in een eigen map onder .claude/skills en Claude Code indexeert ze allemaal. Omdat alleen de beschrijvingen in de context blijven totdat een Skill nodig is, kost het vrijwel niets om er 15 geïnstalleerd te hebben totdat er één wordt geactiveerd.
Heb ik een MCP-server nodig om Skills te gebruiken?
Nee. Skills zijn instructies en werken met de ingebouwde tools van Claude Code (bestandsbewerking, shell, git). MCP-servers voegen externe tools toe, zoals een database of browser; een Skill kan Claude vertellen hoe die tools goed te gebruiken, maar vereist ze niet.
Kort samengevat
Een Claude Code-Skill is een map met een SKILL.md, geplaatst in .claude/skills voor het project of in ~/.claude/skills voor jou, die op basis van de beschrijving wordt gevonden en alleen wordt geladen wanneer dat nodig is. Houd CLAUDE.md kort, gebruik slash-opdrachten voor doelbewuste acties, gebruik MCP voor tools en gebruik Skills voor expertise. Installeer er één, test deze met drie formuleringen en één negatieve formulering en voeg daarna de rest toe naarmate je workflow daarom vraagt.
Blader door elke developer-Skill in de Claude Code Skills-collectie van KissMySkills.
