Claude Code is de enige Claude-interface die daadwerkelijk skills vanaf schijf installeert, wat betekent dat het advies hiervoor anders is dan alles wat over Custom Instructions is geschreven. Dit is een praktische gids: hoe de map werkt, wat een skill de moeite waard maakt en waar mensen hun tijd verspillen.
Hoe skills werken in Claude Code
Skills staan in een .claude/skills/-directory. Elke skill is een submap met daarin een SKILL.md-bestand. Twee locaties zijn belangrijk:
-
Project -
.claude/skills/in de repository. De skill reist mee met de code, zodat iedereen in het team deze krijgt. Hier horen alle projectspecifieke zaken thuis. - Persoonlijk - hetzelfde pad in je thuismap. Dit geldt voor alles waaraan je werkt. Hier horen je eigen gewoonten thuis.
In tegenstelling tot Custom Instructions, waarin je één ding tegelijk kunt bewaren, kan Claude Code veel skills bevatten en de skill gebruiken die past bij wat je doet. Dat verandert hoe een goede skill eruitziet: de beschrijving moet precies genoeg zijn om de juiste skill te selecteren en specifiek genoeg om te voorkomen dat deze voor alles wordt geselecteerd.
Wat een skill echt de moeite waard maakt
Na het bouwen van veel van dit soort skills is het patroon duidelijk. Goede skills leggen beslissingen vast, geen informatie.
Een skill die uitlegt wat een REST API is, verspilt tokens aan iets wat het model al weet. Een skill die zegt: "in deze repository retourneert elk endpoint fouten in de RFC 7807-vorm, en de drie plekken die dat niet doen zijn legacy en mogen niet worden gekopieerd", is het bewaren voor altijd waard, omdat dit een beslissing is die het model niet kan afleiden.
De test: als een competente engineer die bij je team komt dit uitgelegd zou moeten krijgen, zet het dan in een skill. Als die persoon het al zou weten, laat het dan weg.
De categorieën die de moeite waard zijn
Codebeoordeling met een eigen standaard
Algemene reviewopmerkingen zijn ruis. Een reviewskill met de daadwerkelijke conventies van je team — de zaken waarover jullie hebben gediscussieerd en overeenstemming hebben bereikt — verandert een review van een mening in een checklist.
Testconventies
Welk framework je gebruikt, hoe een test wordt genoemd, wat wel en nooit wordt gemockt en wat in deze codebase als voldoende dekking geldt. Zonder deze informatie krijg je tests in de stijl die het meest voorkwam in de trainingsdata.
Debugging en incidentenwerk
Waar de logs staan, welk dashboard welke vraag beantwoordt en welke vier dingen je moet controleren voordat je escaleert. Dit is de skill die zichzelf om 3 uur 's nachts terugverdient.
Infrastructuur en deployment
De deployvolgorde, wat je veilig tegen productie kunt uitvoeren en wat niet, en voor welke migraties een onderhoudsvenster nodig is. Het vastleggen van de gevaarlijke onderdelen is precies het doel.
Documentatie en technisch schrijven
Waar de documentatie staat, welke structuur een pagina volgt en wat in jullie huisstijl het verschil is tussen een tutorial en een naslagwerk.
Wat je kunt overslaan
Taaltutorials. Een skill die Claude Python-syntaxis uitlegt, legt Python-syntaxis uit aan iets dat Python-syntaxis al kent.
Enorme allesomvattende skills. Eén skill voor frontend, backend, testing en deployment wordt voortdurend geladen en is elke keer grotendeels irrelevant. Splits deze op.
Alles wat over een maand verouderd is. Versienummers, de doelen van de huidige sprint en de naam van degene die dienst heeft. Skills zijn bedoeld voor duurzame beslissingen.
Vage beschrijvingen. Als de beschrijving niet duidelijk aangeeft wanneer de skill van toepassing is, wordt deze nooit of juist altijd geselecteerd. Beide zijn nutteloos.
Beginnen met een template in plaats van een lege pagina
Het moeilijkste is niet het idee, maar de vorm: hoe specifiek je moet zijn, wat je moet weglaten en hoe je de beschrijving schrijft zodat de selectie werkt. Dat is het deel dat de moeite waard is om over te nemen uit iets wat al is getest.
We publiceren rolgebaseerde skillbestanden voor ontwikkelaars, DevOps en architecten. Ze zijn geschreven als gewone .md-bestanden en kunnen zowel als Claude Code-skill worden gebruikt als in Custom Instructions worden geplakt:
Claude Code-skills →
Developer-skills →
DevOps-skills →
Architect-skills →
Als je Claude Code niet gebruikt en toch hier terecht bent gekomen, is het equivalent voor Claude op het web Custom Instructions.
KissMySkills is een onafhankelijke marktplaats en is niet gelieerd aan, goedgekeurd door of verbonden met Anthropic, OpenAI of enig ander AI-bedrijf. Claude Code is een product van Anthropic.
