Skills: uitleg, tips en hoe je er het meeste uit haalt
Claude Skills zijn herbruikbare recepten in een SKILL.md-bestand waarmee je Claude een specialisme leert, zoals reviewen, schrijven of rapporteren.
Bouw je eerste Skill in onze e-learningWat is Skills?
Claude Skills, ook wel agent skills genoemd, zijn herbruikbare recepten waarmee je Claude een specialisme leert. Een Skill is in de kern een map met daarin een SKILL.md-bestand en optioneel extra assets zoals templates, voorbeelden of scripts. In SKILL.md leg je vast hoe Claude een bepaalde taak moet uitvoeren: stappen, regels, valkuilen, voorbeelden. Eenmaal aangemaakt kun je dezelfde Skill telkens opnieuw inzetten zonder de instructies te herhalen.
Het idee komt uit de praktijk: je merkt dat je Claude telkens dezelfde uitleg geeft. Hoe een code-review eruit moet zien, hoe een klantmail wordt opgebouwd, hoe je rapporten formatteert. In plaats van die instructies elke keer opnieuw te typen, leg je ze één keer vast in een Skill. Daarna roep je hem op door simpelweg te vragen om de taak. Claude herkent uit jouw verzoek welke Skill past en gebruikt het bijbehorende recept.
Skills horen bij Claude Code en het bredere agent-platform van Anthropic. Ze zijn een eerste-klas concept in Claude Code: een map met SKILL.md in een vaste locatie wordt automatisch herkend. Daarnaast kun je Skills delen met je team door ze in git te zetten of als package te distribueren. Eén persoon bouwt de Skill, de rest profiteert.
Wat Skills onderscheidt van een gewone prompt of een Project, is progressive disclosure. Claude leest niet de hele Skill in elke sessie. Hij ziet alleen de name en description, en besluit op basis daarvan of de Skill nu nuttig is. Pas als de Skill geactiveerd wordt, leest Claude de body en de bijbehorende assets. Dat scheelt context-ruimte en zorgt dat je tientallen Skills kunt hebben zonder dat ze elkaar in de weg zitten.
Hoe werkt Skills?
De anatomie van een SKILL.md
Een SKILL.md begint met een YAML-frontmatter waarin twee velden verplicht zijn: name en description. De name is kort en machineleesbaar, bijvoorbeeld review-code of write-blog-post. De description is één tot drie zinnen die in mensentaal beschrijven wanneer en waarom Claude deze Skill moet inzetten. Daaronder volgt de body: de feitelijke instructies, in vrij markdown. Hierin zet je de stappen die Claude moet volgen, regels, voorbeelden en eventuele verwijzingen naar bestanden in de assets-map. Een minimaal voorbeeld: --- name: review-code description: Gebruik bij PR-reviews of als de gebruiker om code-feedback vraagt. --- gevolgd door je checklist. Houd het kort en concreet, geen verhandeling.
Hoe Claude een Skill activeert
Aan het begin van een sessie ziet Claude de lijst beschikbare Skills met alleen name en description, niet de hele body. Zodra jij iets vraagt, matcht Claude jouw verzoek tegen die descriptions. Vraag je om feedback op een pull request, dan triggert review-code automatisch als de description daar nauw bij aansluit. De description is dus de trigger: het bepaalt of de Skill überhaupt in beeld komt. Een vage description als 'helpt met code' wordt zelden geactiveerd, want hij matcht overal en nergens op. Een scherpe description met duidelijke triggers ('Gebruik bij PR-review, code-feedback of als de gebruiker vraagt om een review') werkt veel beter. Pas als de Skill actief is, leest Claude de body.
Skill-bestanden en assets
Een Skill is meer dan alleen SKILL.md. In dezelfde map kun je extra bestanden zetten waar de Skill naar verwijst: een templates-map met voorbeeld-uitvoer, een referentiebestand met huisstijl-regels, of scripts die Claude mag draaien. De Skill verwijst dan in zijn body naar die bestanden ('lees templates/blog-hero.md voor de juiste opbouw'). Claude haalt die assets pas op zodra de Skill actief is, dus ze tellen niet mee voor de standaard context. Voor een schrijf-skill kun je drie voorbeelden van perfecte output meegeven; voor een rapport-skill een Excel-template. Een Skill met goede assets levert veel consistentere uitvoer dan een Skill met alleen tekstinstructies.
Praktische tips voor Skills
Schrijf de description als trigger, niet als samenvatting
De description is geen bondige samenvatting van wat je Skill doet; hij is een schakelaar. Claude leest hem om te besluiten of de Skill in deze situatie past. Schrijf hem dus vanuit triggers: 'Gebruik bij PR-reviews, code-feedback verzoeken of als de gebruiker vraagt om diff-commentaar.' Vermijd vage formuleringen als 'helpt met code-kwaliteit'. Test je description door verschillende vragen aan Claude voor te leggen en te kijken of hij de juiste Skill kiest. Activeert hij te vaak of juist te weinig, dan stel je de triggers bij.
Een skill, een taak
Maak per Skill één duidelijke taak. Een review-code skill reviewt code, geen tickets en geen e-mails. Hoe scherper je een Skill afbakent, hoe beter Claude weet wanneer hij hem moet inzetten. Doe-alles skills met tien onderwerpen worden zelden of altijd getriggerd, beide ongewenst. Heb je een breed onderwerp, dan splits je: pr-review en bug-rapport in plaats van één code-helper. Liever zes scherpe skills dan twee brede.
Gebruik de assets-map voor templates
Zet alles wat structuur of stijl bepaalt in losse bestanden naast SKILL.md. Voor een blogpost-skill een templates-map met drie voorbeeldposts in perfecte opbouw. Voor een mail-skill een huisstijl-bestand met openings- en afsluitingsregels. Verwijs er in de body naar: 'Volg de structuur van templates/blog-hero.md.' Claude haalt die assets pas op als de Skill actief is, zodat ze geen context vreten. Voorbeelden werken beter dan regels: laat zien hoe goede output eruitziet in plaats van het in woorden te beschrijven.
Test je Skill met diverse vragen
Zodra de Skill werkt, probeer hem uit met vragen die er duidelijk bij horen, vragen die er duidelijk niet bij horen, en vragen die ertussenin zitten. Een Skill die altijd activeert is even fout als eentje die nooit activeert. Houd een lijstje testvragen bij in een README naast de Skill, zodat je na elke wijziging kunt herzien of hij nog correct triggert. Onverwacht gedrag fix je vrijwel altijd in de description.
Versiebeheer in git
Behandel Skills als code. Zet ze in git, schrijf duidelijke commit-berichten en gebruik branches voor experimenten. Zo zie je later waarom een Skill werkt zoals hij werkt, en kun je terug als een wijziging het resultaat slechter maakt. Voor team-skills is dit verplicht: zonder versiebeheer raakt de bron-van-waarheid versnipperd over machines en wordt onduidelijk welke versie de juiste is.
Deel skills met je team
Een Skill die voor jou werkt, werkt waarschijnlijk ook voor je collega's. Plaats team-skills in een gedeelde repo of gebruik de skill-locatie die Claude Code voor projecten herkent. Eén persoon bouwt en onderhoudt de Skill, de rest gebruikt hem. Daarmee voorkom je dat iedereen zijn eigen review-recept verzint. Spreek af wie eigenaar is van welke Skill en wie wijzigingen goedkeurt, anders ontstaat er drift.
Houd triggers expliciet
Vermeld in je description concrete signaalwoorden waar jij of je team aan denkt: 'PR-review', 'diff bekijken', 'code feedback'. Hoe explicieter de termen, hoe betrouwbaarder de match. Generieke woorden als 'helpen', 'kijken naar' of 'iets met code' leveren wisselvallige activatie op. Schrijf de description in de taal waarin je doorgaans werkt: Nederlands als je team Nederlands praat, Engels als de codebase Engels is.
Begin klein en breid uit
Start met één Skill voor een taak die je elke week doet. Werk hem af, gebruik hem een week, scherp de description aan op basis van wat je merkt. Pas daarna bouw je de volgende. Tien half-werkende Skills zijn waardelozer dan twee scherp werkende. De grootste fout is op dag één een hele skill-bibliotheek willen opzetten en op dag drie merken dat de helft nooit triggert.
Wanneer kies je voor Skills?
Skills lijken op verschillende andere manieren om Claude te sturen, maar verschillen in waar ze zitten, wanneer ze actief worden en wat ze toevoegen. Een Project bewaart context per onderwerp, een Custom GPT is een aparte chatbot, een prompt is eenmalig, en MCP koppelt externe tools. Skills voegen herbruikbare recepten toe die Claude zelf kiest wanneer ze passen. Vaak gebruik je ze naast elkaar: een Project voor de context van een klant, een MCP voor de database, en een Skill voor de manier waarop je rapporten opstelt.
| Vergelijking | Wat het betekent |
|---|---|
| Skills vs Claude Projects | Een Project is een container met vaste context, bestanden en custom instructions voor een onderwerp of klant. Skills zijn taakgericht en werken over Projects heen: dezelfde review-code skill gebruik je in elk project. Je combineert ze: een Project voor de klantcontext, een Skill voor de werkwijze. |
| Skills vs Custom GPTs | Een Custom GPT bij OpenAI is een complete chatbot-variant met eigen interface en URL. Een Skill is geen aparte assistent maar een recept dat de bestaande Claude oppakt wanneer relevant. Skills triggeren automatisch op basis van je verzoek; bij een Custom GPT moet je expliciet naar die GPT toe. |
| Skills vs Prompts | Een prompt is eenmalig: je typt hem, krijgt antwoord, klaar. Een Skill is een prompt die je vastlegt en die zichzelf activeert zodra het verzoek erbij past. Heb je een prompt die je vaak hergebruikt, dan is dat een kandidaat-skill. Eenmalige instructies blijven prompts. |
| Skills vs MCP | MCP koppelt Claude aan externe systemen en data: database, GitHub, je eigen API. Skills voegen geen toegang toe maar werkwijze: hoe Claude een taak aanpakt. Ze vullen elkaar aan: een MCP voor de Supabase-verbinding, een Skill voor de manier waarop je query-resultaten samenvat. |
Veelgestelde vragen over Skills
Wat is SKILL.md precies?
SKILL.md is een markdown-bestand met een YAML-frontmatter en een body. In de frontmatter staan de velden name en description; in de body staan de instructies in vrij markdown. Het bestand staat in een map met de naam van de Skill, eventueel naast bijbehorende assets zoals templates en voorbeelden. Claude Code herkent deze structuur automatisch zodra de map op de juiste locatie staat. Eén SKILL.md per skill: meerdere skills in één bestand is geen geldige structuur.
Hoe bouw ik mijn eerste Skill?
Kies een taak die je vaak doet en die telkens dezelfde uitleg vergt: een review, een rapport, een mailopzet. Maak een map met de naam van de skill en zet daar een SKILL.md in met een name en een scherpe description (de trigger). Vul de body met de stappen die jij zelf zou volgen, voeg eventueel templates of voorbeelden toe in een assets-map. Test de skill door verzoeken te stellen die er wel en niet bij horen. Pas de description aan tot Claude betrouwbaar de juiste keuze maakt.
Werken Skills in de Claude web-app?
Skills zijn ontstaan in Claude Code en zijn daar een eerste-klas concept met een vaste mapstructuur die de CLI automatisch leest. In de web-app bestaat een vergelijkbaar mechanisme via Projects en custom instructions, maar de SKILL.md-aanpak met progressive disclosure en assets-mappen werkt het best in Claude Code en op het bredere agent-platform van Anthropic. Voor losse chatwerk in de browser zijn Projects vaak de praktische tegenhanger.
Kan ik Skills delen met mijn team?
Ja. Zet de skill-map in een gedeelde git-repo of in de projectlocatie die Claude Code voor het team herkent. Iedereen die de repo cloont krijgt de skill automatisch beschikbaar. Voor grotere teams werkt het goed om één eigenaar per skill aan te wijzen die wijzigingen reviewt, zodat de werkwijze niet uiteen gaat lopen. Behandel team-skills als productiecode: pull requests, reviews en duidelijke commit-berichten.
Wat is het verschil met Custom GPTs?
Een Custom GPT van OpenAI is een aparte assistent met eigen pagina, naam en gespreksgeschiedenis. Je opent hem expliciet wanneer je hem wilt gebruiken. Een Skill bij Claude is geen aparte assistent: hij activeert zichzelf binnen je gewone Claude-sessie zodra je verzoek bij zijn description past. Dat scheelt context-switchen. Daarnaast bestaan Skills uit bestanden in jouw repo die je in git kunt zetten, terwijl Custom GPTs in de OpenAI-omgeving leven.
Hoe weet Claude welke Skill te gebruiken?
Claude ziet aan het begin van een sessie de lijst van beschikbare skills met alleen name en description, niet de body. Wanneer jij iets vraagt, vergelijkt hij jouw verzoek met die descriptions en kiest de best passende skill. Daarom is een scherpe description die concrete triggers noemt zo belangrijk: hij is het enige waar Claude op selecteert. Pas als een skill actief wordt, leest Claude de body en bijbehorende assets. Dit principe heet progressive disclosure en zorgt dat je veel skills kunt hebben zonder context-druk.
Mag een Skill scripts uitvoeren?
Een Skill kan verwijzen naar scripts in zijn assets-map, en Claude kan die scripts uitvoeren als de omgeving daar toestemming voor geeft. In Claude Code regel je dat via settings.json: welke commando's mogen zonder vragen, welke vragen altijd om bevestiging. Voor gevoelige skills kun je per repo een eigen .claude/settings.json zetten met striktere regels. Behandel scripts in een skill net zo voorzichtig als andere code: review wat erin staat voordat je hem in je team uitrolt.
Verschillen Skills van plugins of extensions?
Plugins en extensions voegen nieuwe knoppen of integraties toe aan een applicatie. Skills voegen niets toe aan de interface, ze voegen werkwijze toe aan Claude. Je ziet ze niet als knop terug; ze worden zichtbaar in het gedrag van Claude wanneer hij ze activeert. Daardoor zijn ze stil aanwezig: ze beïnvloeden uitvoer zonder de gebruikerservaring te verstoren.