Claude skills installeren, overal waar je werkt.
Claude skills installeren is geen technisch project: het is een zip uitpakken in de juiste map, een bestand uploaden of een stuk tekst plakken. Deze gids loopt elke omgeving langs, stap voor stap: Claude Code, Claude.ai, Codex, en de tools die sinds de open standaard hetzelfde bestand lezen, zoals Cursor en Gemini CLI. Met daarbij de fouten die het vaakst misgaan en hun oplossing, en een gratis skill die je installatie voor je controleert.
- Pak de zip uit in
~/.claude/skills/of in.claude/skills/binnen je project. - Claude herkent de skill daarna vanzelf zodra je een skill wilt laten controleren.
- Direct aanroepen kan met
/skill-installatie-checker.
- Ga naar Customize en dan Skills.
- Upload daar de zip als skill.
- Of plak de inhoud van SKILL.md in de projectinstructies van een Project.
- Plak de inhoud van SKILL.md in je
AGENTS.md. - Of zet SKILL.md als los bestand in je repo en verwijs ernaar vanuit
AGENTS.md. - Codex leest dat bij elke sessie mee.
Wat je eigenlijk installeert
reg. I.001Voordat je iets installeert, helpt het om te weten wat een skill fysiek is: een map met daarin één verplicht tekstbestand, SKILL.md. Geen programma, geen extensie, geen app. Bovenin dat bestand staat een kort blok met de naam en een beschrijving, daaronder staan de instructies die je AI-assistent volgt zodra de skill actief wordt. Wie deze opbouw eenmaal kent, begrijpt ook meteen waarom elke installatiefout in deze gids op hetzelfde neerkomt: iets in die kleine structuur staat net verkeerd. Wat een skill inhoudelijk is en wat je eraan hebt, lees je in de zusterblog wat zijn Claude skills; hier gaat het over het installeren zelf.
SKILL.mdHoofdletters, exact deze naam, direct in de skillmap. Dit is het enige verplichte bestand; een skill mag daarnaast extra bestanden meeleveren.verplichtnameVerplicht. Maximaal 64 tekens, kleine letters, cijfers en koppeltekens. Moet gelijk zijn aan de mapnaam uit laag 02.max 64 tekensdescriptionVerplicht. Zegt wat de skill doet en wanneer hij gebruikt moet worden. Op dit veld beslist je tool of de skill vanzelf wordt ingezet.max 1024 tekensDe map is de installatie
reg. I.002In Claude Code bestaat er geen installatieknop, en dat is goed nieuws: de installatie is niets meer dan de skillmap op de juiste plek zetten. Er zijn twee juiste plekken. De map ~/.claude/skills/ in je thuismap geldt voor alles wat je op die computer doet, de map .claude/skills/ binnen een project geldt alleen daar. Persoonlijke werk-skills horen in de eerste, projectafspraken die je met teamgenoten deelt in de tweede, want die map reist mee met de repository.
/skill-installatie-checker. Die naam is exact de mapnaam, en dat is meteen de reden dat mapnaam en frontmatter-naam gelijk moeten zijn.~/.claude/skills/ slepen doet exact hetzelfde. Let er alleen op dat je bestandsbeheer geen extra map om de inhoud heen zet bij het uitpakken; hoe je dat controleert staat in sectie 05.Uploaden of plakken
reg. I.003Werk je niet in een terminal maar in de browser, dan zijn er twee routes: de zip als skill uploaden in Claude.ai, of de inhoud van SKILL.md ergens plakken waar je assistent hem bij elke sessie meeleest. Dat tweede werkt overal, ook in Codex. Het verschil is wezenlijk: een geüploade skill wordt alleen actief wanneer het onderwerp erom vraagt, geplakte instructies lezen altijd mee. Voor één of twee skills maakt dat niets uit; wie er tien wil gebruiken, wil de echte skill-route.
- Open Customize en ga naar Skills.
- Upload daar de zip als skill.
- De skill doet voortaan mee zodra je vraag erom vraagt.
- Open SKILL.md in een teksteditor en kopieer alles.
- Plak het in de projectinstructies van een Project.
- Binnen dat Project leest elke chat de instructies mee.
- Plak de inhoud van SKILL.md in je
AGENTS.md. - Of zet SKILL.md los in je repo en verwijs ernaar vanuit
AGENTS.md. - Codex leest dat bestand bij elke sessie mee.
AGENTS.md is de juiste route als je omgeving geen skill-upload heeft, of als de skill zo centraal is voor je project dat hij er altijd bij moet zijn. Het nadeel is even eerlijk benoemd: alles wat altijd meeleest, telt altijd mee in de context van je assistent. Tien geplakte skills maken elke sessie trager en duurder; tien geïnstalleerde skills kosten alleen iets als ze meedoen.Eén bestand, meerdere tools
reg. I.004Sinds december 2025 is Agent Skills een open standaard. Dat klinkt als een voetnoot, maar het verandert wat je koopt als je tijd in een skill steekt: hetzelfde SKILL.md-bestand dat je voor Claude schrijft of downloadt, wordt ook gelezen door andere tools die de standaard volgen. Cursor en Gemini CLI horen daarbij. Je bouwt dus geen verzameling voor één leverancier op, maar een gereedschapskist die meeverhuist als je van tool wisselt.
- Uitpakken in
~/.claude/skills/of.claude/skills/in het project. - Vanzelf herkend, direct aanroepen met
/skillnaam.
- Zip uploaden via Customize en dan Skills.
- Of SKILL.md plakken in de projectinstructies.
- Inhoud plakken in
AGENTS.md, of los bestand plus verwijzing. - Wordt bij elke sessie meegelezen.
- Ondersteunt de open standaard; waar de skillmap staat verschilt per versie.
- Wat altijd werkt: SKILL.md-inhoud opnemen in het instructiebestand dat Cursor leest, zoals
AGENTS.md.
- Ondersteunt de open standaard; het skillpad verschilt per versie.
- Wat altijd werkt: de inhoud opnemen in het contextbestand dat de tool bij elke sessie leest.
- De standaard wordt breder gedragen; elke tool die hem volgt leest hetzelfde SKILL.md.
- Raadpleeg de documentatie van je eigen tool voor de plek.
name en description, en instructies in gewone taal. Daarom is een skill die de checklist van dit artikel doorstaat meteen in elke omgeving bruikbaar. Hoe je binnen die regels een goede skill schrijft, staat in zelf een SKILL.md schrijven.Als de skill niet doet wat je verwacht
reg. I.005Vrijwel elke mislukte installatie valt terug te brengen tot vijf oorzaken, en ze zijn allemaal in een minuut te vinden als je weet waar je kijkt. Loop de log hieronder van boven naar beneden door; de volgorde is de volgorde waarin de fouten in de praktijk het vaakst voorkomen. En wil je dit niet met de hand doen: de checker-skill bovenaan deze pagina loopt exact deze punten voor je na op een geplakte SKILL.md of mapstructuur.
name-veld in de frontmatter. Fix: hernoem de map of het veld tot ze exact gelijk zijn, kleine letters en koppeltekens.NAAMskillmap/skillmap/SKILL.md. Fix: verplaats de binnenste map een niveau omhoog; SKILL.md hoort direct in de skillmap.STRUCTUURWaarom die mapstructuur zo nauw luistert
Het voelt onnodig streng: een skill die perfect geschreven is, doet het niet omdat een mapnaam één hoofdletter bevat. Maar die strengheid is precies wat skills betrouwbaar maakt. Je AI-assistent leest bij de start van een sessie niet al je skills volledig in, dat zou traag en duur zijn. Hij leest alleen de frontmatter van elk SKILL.md-bestand dat hij op de afgesproken plekken vindt, en bouwt daarmee een register: deze namen bestaan, dit is wat ze doen. Pas wanneer een skill echt nodig is, wordt de volledige inhoud geladen.
Dat verklaart elke regel uit de checklist
De mapnaam moet gelijk zijn aan het name-veld omdat de map het adres is en het veld de naam op de deurbel; wijken ze af, dan is de skill onvindbaar of verschijnt hij onder een naam die niemand verwacht. SKILL.md moet exact zo heten omdat de assistent daar zoekt en nergens anders. En de frontmatter moet op regel één beginnen omdat alles boven die eerste streepjesregel het blok ongeldig maakt, waarna het hele bestand als gewone tekst geldt en de skill simpelweg niet bestaat voor het register.
Wie dit eenmaal doorheeft, hoeft nooit meer te zoeken bij een mislukte installatie
Er zijn maar drie vragen: kan mijn tool de map vinden, kan hij de frontmatter lezen, en zegt de description genoeg om de skill op het juiste moment in te zetten. Alles in deze gids is een uitwerking van die drie vragen, en de gratis scan-mentaliteit die we voor websites hanteren geldt hier net zo: eerst meten waar het misgaat, dan pas sleutelen.
De description bepaalt of je skill ooit meedoet
De meest onderschatte regel van het hele formaat is niet de mapstructuur maar het description-veld. Dat veld is niet alleen documentatie voor mensen: het is het enige wat je assistent van de skill ziet zolang de skill niet actief is. Op basis van die ene alinea beslist hij bij elke vraag of deze skill relevant is. Een description die alleen zegt wat de skill is, verliest die afweging vrijwel altijd van de eigen kennis van het model. Een description die zegt wanneer de skill moet aanslaan, met letterlijke formuleringen die een gebruiker zou typen, wint hem.
Vergelijk twee versies voor dezelfde skill
Controleert een SKILL.md op fouten is waar, maar vaag. Gebruik deze skill wanneer iemand vraagt waarom wordt mijn skill niet herkend, controleer mijn frontmatter of check mijn SKILL.md is even waar, en geeft het model drie concrete zinnen om jouw vraag aan te herkennen. Onze eigen skills, van de SWOT-analyse tot de Eisenhower Matrix Coach, dragen daarom allemaal een lange description vol letterlijke triggerzinnen, en dat is geen opsmuk maar de aan-uitknop van het hele systeem.
Er is één grens: de description mag maximaal 1024 tekens lang zijn, dus elke zin moet er een verdienen
Zeg wat de skill doet, noem de situaties waarin hij moet aanslaan, en sluit af met wanneer hij juist niet gebruikt moet worden, want ook dat voorkomt ruis. Wie dit goed doet, merkt het verschil direct: de skill duikt vanzelf op waar hij hoort, in plaats van te wachten tot jij aan hem denkt. Meer schrijfregels als deze staan in zelf een SKILL.md schrijven.
Lees wat je installeert, zeker als het gratis is
Zo'n skill is tekst, en dat maakt hem transparanter dan vrijwel alle andere software die je installeert: je kunt vooraf letterlijk lezen wat hij gaat doen. Doe dat dan ook. Open de SKILL.md in een teksteditor voordat je hem installeert en lees hem zoals je een werkinstructie voor een nieuwe collega zou lezen. Kloppen de beloftes met de instructies? Vraagt de skill om dingen die nergens voor nodig zijn? Instructies sturen wat je assistent doet en welke informatie hij waar naartoe schrijft, dus een slordige of kwaadwillende skill is meer dan een cosmetisch probleem.
Twee dingen horen bij een eerlijk verhaal
Ten eerste staat de standaard toe dat een skill naast SKILL.md ook extra bestanden en scripts meelevert; bij zulke skills is er dus meer te controleren dan één tekstbestand, en geldt dezelfde regel als bij elke download: ken je bron. Ten tweede is een licentie geen detail. Onze skills zijn MIT-gelicenseerd, wat betekent dat je ze mag lezen, aanpassen en zakelijk gebruiken; bij skills zonder licentie is dat formeel niet geregeld, hoe gratis de download ook voelt.
Onze eigen bibliotheek is op dit punt bewust saai gehouden: elke zip bevat precies één map met precies één SKILL.md, zonder scripts en zonder verrassingen, en het hele bestand is in een minuut te lezen. Dat is geen gebrek aan ambitie maar een keuze: een skill die je in één oogopslag kunt beoordelen, wordt vaker geïnstalleerd en beter vertrouwd. Wat er allemaal in die bibliotheek zit, van analyse tot pre-mortem, zie je op de skills-pagina.
Na de installatie: testen, bijhouden, opruimen
Een skill installeren is stap één; weten dat hij werkt is stap twee, en die slaan de meeste mensen over. De test kost een minuut. Start een nieuwe sessie, roep de skill expliciet aan en geef hem een echte opdracht, niet een testje van drie woorden. Doet hij wat de beschrijving belooft, stel dan dezelfde vraag in een verse sessie zonder de skill te noemen. Slaat hij nu vanzelf aan, dan is de installatie compleet. Zo niet, dan werkt de skill wel maar zijn description niet, en weet je meteen waar je moet sleutelen.
Bijhouden is daarna vooral een kwestie van niet verzamelen om het verzamelen
Skills die je nooit gebruikt, maken het register voller en de automatische keuze van je assistent ruiser. Loop je map af en toe door en gooi weg wat je in een maand niet hebt ingezet; verwijderen is letterlijk de map weggooien, er is geen deïnstallatieprogramma. En werk je in een team, zet gedeelde skills dan in de projectmap in plaats van ieders thuismap, zodat iedereen dezelfde versie draait en een verbetering maar op één plek hoeft.
Wil je hierna verder, dan is de volgorde logisch: eerst begrijpen wat skills zijn in wat zijn Claude skills, dan een paar installeren uit de bibliotheek, en daarna zelf schrijven met zelf een SKILL.md schrijven. En zie je na een paar weken dat skills echt werk uit handen nemen, dan is de vervolgvraag hoe je dit breder in je bedrijf zet. Dat is het vak van onze AI en automatisering-tak, en daar denken we graag over mee in een gesprek.
Veelgestelde vragen
Waar zet ik een skill neer in Claude Code?
Op een van twee plekken. Pak de zip uit in ~/.claude/skills/ in je thuismap en de skill werkt in al je projecten, of pak hem uit in .claude/skills/ binnen een project en hij werkt alleen daar. Daarna herkent Claude de skill vanzelf zodra je vraag bij het onderwerp past, en direct aanroepen kan altijd met een schuine streep gevolgd door de skillnaam.
Werkt dezelfde skill in Claude, Codex en Cursor?
Ja. Agent Skills is sinds december 2025 een open standaard, dus hetzelfde SKILL.md-bestand werkt in Claude.ai, Claude Code, Codex en in andere omgevingen die de standaard volgen, waaronder Cursor en Gemini CLI. Wat per tool verschilt is alleen de plek waar je de skill neerzet en hoe je hem aanwijst. Voor tools waarvan de mappen per versie verschillen werkt er altijd een ding: de inhoud van SKILL.md opnemen in het instructiebestand dat de tool bij elke sessie leest.
Mijn skill wordt niet herkend, wat controleer ik eerst?
Vier dingen, in deze volgorde. Een: heet de map exact hetzelfde als het name-veld in de frontmatter. Twee: staat SKILL.md direct in die map, zonder extra maplaag ertussen en niet los in de root. Drie: begint het bestand op regel een met drie streepjes en wordt dat blok ook weer met drie streepjes gesloten. Vier: start een nieuwe sessie, want een skill die je toevoegt terwijl een sessie loopt doet pas mee vanaf de volgende. De gratis checker-skill bij dit artikel loopt deze punten automatisch voor je na.
Moet ik kunnen programmeren om een skill te installeren?
Nee. Een skill installeren is een zip uitpakken in de juiste map, een bestand uploaden via de instellingen, of de inhoud van een tekstbestand ergens in plakken. Meer dan een bestandsbeheerder en een teksteditor heb je niet nodig. Alleen als je skills wilt schrijven of aanpassen moet je iets van de opbouw begrijpen, en ook dat is tekst schrijven en geen code.
Zijn de skills van ons gratis en mag ik ze aanpassen?
Ja. Alle skills in onze bibliotheek zijn gratis te downloaden zonder account, en ze vallen onder de MIT-licentie. Dat betekent dat je ze mag gebruiken, aanpassen en delen, ook zakelijk. Elke skill is een zip met een SKILL.md erin, dus je kunt hem openen, lezen en naar je eigen situatie ombuigen voordat je hem installeert.
Is het veilig om een gedownloade skill te installeren?
Een skill is in de basis een tekstbestand met instructies, maar die instructies sturen wel wat je AI-assistent doet, en de standaard staat toe dat een skill naast SKILL.md ook scripts en andere bestanden meelevert. Behandel een skill daarom als alles wat je installeert: lees eerst wat erin staat, zeker als hij uit een onbekende bron komt. Onze skills bestaan uit een enkel SKILL.md-bestand dat je in elke teksteditor kunt openen en controleren.
Installeer er vandaag één, en test hem echt
De beste manier om dit artikel te onthouden is het één keer te doen. Kies een skill uit de bibliotheek die bij je werk past, zet hem neer volgens de stappen van jouw omgeving, en geef hem een echte opdracht. Loop je vast, dan staat de oorzaak vrijwel zeker in FIG.05, en de checker-skill vindt hem voor je.
Wil je daarna dieper, lees dan wat zijn Claude skills voor het waarom en zelf een SKILL.md schrijven voor het zelf bouwen. Meer leren over vindbaar zijn in AI-antwoorden kan bij SEO verbeteren en in de kennisbank, en hoe wij AI dagelijks inzetten zie je bij onze software. En wil je dat je hele team dit kan, dan is dat precies waarvoor onze AI-trainingen bestaan.