Een Claude Skill maken (stap voor stap, met een gratis sjabloon)

9 min lezen KissMySkills

Om een Claude-skill te maken, schrijf je één map met daarin één bestand: een SKILL.md dat begint met een naam en een beschrijving, gevolgd door instructies in gewone taal. Zip de map, upload deze naar Claude (of plaats hem in ~/.claude/skills/ voor Claude Code), waarna Claude hem laadt telkens wanneer een verzoek overeenkomt met de beschrijving. Geen code, geen SDK, geen buildstap.

Op deze pagina
  1. Wat je nodig hebt voordat je begint
  2. Stap 1: Kies één taak en bepaal wanneer die "klaar" is
  3. Stap 2: Maak de map en het bestand SKILL.md aan
  4. Stap 3: Schrijf de frontmatter (het deel dat bepaalt wanneer deze wordt geactiveerd)
  5. Stap 4: Schrijf de instructies als een methode, niet als een stemming
  6. Stap 5: Voeg één voorbeeld van voltooide uitvoer toe
  7. Stap 6: Verpak en installeer hem
  8. Stap 7: Test hem alsof je het meent
  9. Gratis Claude Skill-template (kopiëren en aanpassen)
  10. Vijf fouten die een Skill nutteloos maken
  11. Laat Claude het eerste concept voor je schrijven
  12. Zelf bouwen of beginnen met een kant-en-klare Skill?

Dat is het hele mechanisme. Het verschil tussen een skill die elke keer wordt geactiveerd en werk oplevert dat je kunt versturen, en een skill die nooit wordt geactiveerd, zit in ongeveer zes beslissingen. Deze handleiding behandelt ze in volgorde. Aan het einde vind je een gratis sjabloon dat je kunt kopiëren en een checklist om je skill te testen voordat je erop vertrouwt.

Als het idee zelf nieuw voor je is, begin dan met Wat zijn Claude Skills? en kom daarna terug. Deze pagina gaat ervan uit dat je weet wat een skill is en er een wilt bouwen.

Wat je nodig hebt voordat je begint

  • Een Claude-account waarop code-uitvoering is ingeschakeld. Skills werken met de abonnementen Free, Pro, Max, Team en Enterprise, maar de instelling voor code-uitvoering en het aanmaken van bestanden moet zijn ingeschakeld. Bij Team en Enterprise moet een beheerder skills mogelijk eerst voor de organisatie inschakelen.
  • Een teksteditor. Alles waarmee je platte tekst kunt opslaan: VS Code, TextEdit in de modus voor platte tekst, Kladblok.
  • Eén herhaalbare taak. Niet "marketing". Iets als "zet een transcript van een salesgesprek om in een CRM-notitie volgens ons format" of "controleer een contract op onze vijf standaardrisico's". Hoe specifieker de taak, hoe beter de skill.
  • Twee of drie echte voorbeelden van goede uitvoer. Eerdere rapporten, e-mails en briefings die je met plezier zou versturen. Dit is het beste ruwe materiaal voor een skill.

Stap 1: Kies één taak en bepaal wanneer die "klaar" is

De meeste mislukte skills gaan hier al de mist in, voordat er ook maar één regel is geschreven. Een skill die "alles wat een marketingmanager doet" probeert te omvatten, eindigt met een vage beschrijving, wordt op de verkeerde momenten geactiveerd en geeft algemene antwoorden wanneer dat wel gebeurt.

Schrijf eerst twee zinnen voordat je iets anders doet:

  1. De trigger: "Gebruik dit wanneer iemand om X vraagt of Y aanlevert."
  2. Het resultaat: "De uitvoer is een Z met deze secties, in deze lengte en met deze toon."

Voorbeeld: "Gebruik dit wanneer iemand een transcript van een klantgesprek plakt en om notities vraagt. De uitvoer is een CRM-notitie met Samenvatting, Pijnpunten, Budget, Volgende stap en Risico, van minder dan 200 woorden, geschreven voor een salesmanager die niet bij het gesprek aanwezig was." Als je die twee zinnen niet kunt schrijven, splits de taak dan op in twee skills.

Stap 2: Maak de map en het bestand SKILL.md aan

Een skill is een map waarvan de naam overeenkomt met de naam van de skill. Het enige vereiste bestand daarin is SKILL.md (de bestandsnaam is hoofdlettergevoelig). Optionele extra's komen ernaast te staan:

Pad Verplicht? Waarvoor het dient
call-notes/SKILL.md Ja Frontmatter plus de instructies die Claude volgt
call-notes/resources/example-output.md Aanbevolen Een voltooid voorbeeld van het eindproduct
call-notes/resources/style-guide.md Optioneel Langer referentiemateriaal dat Claude alleen leest wanneer dat nodig is
call-notes/scripts/ Optioneel Python- of shellscripts voor stappen die exact moeten zijn, zoals het parseren van een CSV

Houd de mapnaam klein en gebruik koppeltekens, zoals call-notes of quarterly-report. Dezelfde tekenreeks staat in het naam veld in de volgende stap.

Stap 3: Schrijf de frontmatter (het deel dat bepaalt wanneer deze wordt geactiveerd)

Het bestand begint met een kort YAML-blok tussen twee regels met drie koppeltekens. Twee velden zijn verplicht:

  • name - kleine letters, cijfers en koppeltekens, maximaal 64 tekens. Dit wordt de identificatie en in Claude Code de slashopdracht (/call-notes).
  • description - maximaal 1.024 tekens. Dit is het enige deel dat Claude aan het begin van een sessie voor elke geïnstalleerde vaardigheid leest. Het bepaalt of je vaardigheid überhaupt wordt geladen.

Schrijf de beschrijving alsof je een collega instrueert die in één seconde moet beslissen of een verzoek voor hem of haar is. Begin met wat de vaardigheid oplevert en vermeld daarna de situaties en formuleringen die deze moeten activeren. Vergelijk:

  • Zwak: "Helpt met verkoopnotities."
  • Sterk: "Zet een transcript van een verkoop- of kennismakingsgesprek om in een gestructureerde CRM-notitie (Samenvatting, Pijnpunten, Budget, Volgende stap, Risico) van minder dan 200 woorden. Gebruik dit wanneer de gebruiker een transcript van een gesprek, tekst van een opgenomen vergadering of ruwe gespreksnotities plakt en om notities, een samenvatting, een CRM-vermelding of een follow-upsamenvatting vraagt."

De sterke versie benoemt de invoer, de uitvoer en de woorden die mensen daadwerkelijk typen. Daardoor wordt de vaardigheid betrouwbaar geactiveerd en blijft deze de rest van de tijd stil.

Stap 4: Schrijf de instructies als een methode, niet als een stemming

Alles onder de frontmatter is Markdown die Claude volgt zodra de vaardigheid wordt geladen. De meest gemaakte fout is een lange persona ("Je bent een wereldberoemde verkoopexpert met 20 jaar ervaring...") zonder procedure. Claude heeft geen achtergrondverhaal nodig. Het heeft stappen, regels en een beoogde indeling nodig. Een structuur die voor de meeste bedrijfsvaardigheden werkt:

  1. Invoer - wat de gebruiker aanlevert en waar je om moet vragen als dit ontbreekt (maximaal twee vragen, daarna doorgaan met de genoemde aannames).
  2. Workflow - genummerde stappen in de volgorde waarin een zorgvuldige professional ze zou uitvoeren.
  3. Uitvoerindeling - de exacte secties, koppen, lengte en toon.
  4. Regels - de dingen die altijd of nooit mogen gebeuren ("verzin nooit een budgetbedrag; schrijf 'niet besproken'").
  5. Kwaliteitscontrole - een korte lijst die Claude doorloopt voordat het antwoord geeft.

Streef naar iets dat op één of twee schermen past. Als het bestand langer wordt dan ongeveer 500 regels, verplaats dan referentiemateriaal (lange stijlgidsen, prijslijsten, beleidsteksten) naar bestanden onder resources/ en vertel Claude in SKILL.md wanneer hij ze moet openen. Lees voor meer informatie over de bestandsstructuur Wat is een SKILL.md-bestand?

Stap 5: Voeg één voorbeeld van voltooide uitvoer toe

Een voorbeeld leert het formaat sneller dan welke hoeveelheid beschrijving ook. Plaats één realistisch, voltooid resultaat in resources/example-output.md en verwijs ernaar vanuit de workflow ("pas de structuur en lengte van resources/example-output.md aan"). Gebruik een echt, eerder voltooid werkstuk waarvan je de namen en cijfers hebt aangepast, geen placeholder vol haakjes. Onze eigen catalogus volgt dezelfde regel: elke Skill wordt geleverd met een voorbeelduitvoer, omdat dat het duidelijkste bewijs is dat iemand het ding daadwerkelijk heeft getest.

Stap 6: Verpak en installeer hem

In Claude (web en desktop): zip de map zodat de map zelf in de hoofdmap van het zipbestand staat (call-notes.zip met daarin call-notes/SKILL.md). Open het gedeelte Skills in je instellingen, upload het zipbestand en schakel de Skill in. Start een nieuwe chat en doe een verzoek dat overeenkomt met de beschrijving.

In Claude Code: je hebt geen zipbestand nodig. Plaats de map in ~/.claude/skills/ om hem in elk project te gebruiken, of in .claude/skills/ binnen een repository om hem te delen met iedereen die aan die repository werkt. Typ /call-notes of beschrijf gewoon de taak. Claude Code neemt wijzigingen in de map over zonder opnieuw op te starten.

De volledige uitleg voor elk oppervlak, inclusief waar de bestanden staan en wat je moet doen als een upload wordt geweigerd, vind je in Een Claude Skill installeren. Ontwikkelaars die voornamelijk in de terminal werken, moeten ook Claude Code Skills lezen.

Stap 7: Test hem alsof je het meent

Een Skill die maar één keer is uitgeprobeerd, is niet getest. Voer deze controle uit voordat je hem met een team deelt:

  1. Triggertest (5 prompts). Schrijf vijf verzoeken die de Skill zouden moeten activeren, verschillend geformuleerd. Tel hoeveel er worden geactiveerd. Minder dan vier betekent dat de beschrijving meer van de echte bewoordingen van de gebruiker nodig heeft.
  2. Stiltetest (5 prompts). Schrijf vijf vergelijkbare verzoeken die het niet zouden moeten activeren. Als het bij een ervan wordt geactiveerd, maak de beschrijving specifieker.
  3. Test op ontbrekende invoer. Geef het de helft van de invoer. Het moet een korte vraag stellen of zijn aannames aangeven, geen feiten verzinnen.
  4. Indelingstest. Vergelijk drie uitvoerresultaten naast elkaar met je voorbeeld. Dezelfde secties, dezelfde lengtecategorie, dezelfde toon?
  5. Test voor uitzonderingsgevallen. Voer de rommeligste echte input in die je hebt: een onsamenhangend transcript, een halflege spreadsheet.

Herstel de beschrijving bij activeringsproblemen en de workflow of regels bij uitvoerproblemen. Houd onderaan het bestand een korte changelog bij, zodat je weet welke versie je team gebruikt.

Gratis Claude Skill-template (kopiëren en aanpassen)

Vervang de onderdelen in hoofdletters, verwijder wat je niet nodig hebt en sla het op als SKILL.md in een map met dezelfde naam als het naam veld.

---
name: naam-van-je-skill
description: Produceert EEN SPECIFIEK RESULTAAT (secties, lengte) op basis van EEN SPECIFIEKE INPUT. Gebruik deze Skill wanneer de gebruiker OM X VRAAGT, Y PLAKT of Z NOEMT. Gebruik deze niet voor EEN VERWANTE TAAK DIE ELDERS HOORT.
---

# TITEL VAN JE SKILL

## Doel
Eén of twee zinnen: voor wie dit bedoeld is en wanneer het als "klaar" geldt.

## Input
- Verplicht: WAT DE GEBRUIKER MOET AANLEVEREN
- Optioneel: WAT HET RESULTAAT VERBETERT
- Als verplichte input ontbreekt, stel dan maximaal twee korte vragen,
  ga daarna verder en zet je aannames bovenaan de uitvoer.

## Workflow
1. Lees de input en identificeer de BELANGRIJKSTE ELEMENTEN.
2. Controleer de uitvoer aan de hand van REGELS OF CRITERIA.
3. Stel de uitvoer op in het onderstaande format.
4. Voer de kwaliteitscontrole uit, herstel alles wat niet slaagt en antwoord daarna.

## Uitvoerformaat
- Sectie 1: NAAM - WAT KOMT HIER (lengte)
- Sectie 2: NAAM - WAT KOMT HIER (lengte)
- Sectie 3: NAAM - WAT KOMT HIER (lengte)
Stem de structuur en lengte af op resources/example-output.md.

## Regels
- Verzin nooit cijfers, namen of datums. Schrijf in plaats daarvan "niet verstrekt".
- Gebruik eenvoudig Engels. Geen loze inleidingen.
- REGEL DIE SPECIFIEK IS VOOR JE TEAM OF BRANCHE.

## Kwaliteitscontrole
- Is elke sectie aanwezig en staat die in de juiste volgorde?
- Is elke bewering herleidbaar tot de input?
- Binnen de lengtelimiet?

## Changelog
- v1.0 EERSTE VERSIE, DATUM

Wil je zien hoe voltooide Skills eruitzien? Claude Skill Examples behandelt twaalf echte SKILL.md-bestanden regel voor regel. Dat is de snelste manier om te bepalen hoeveel detail genoeg is.

Vijf fouten die een Skill nutteloos maken

  • Een beschrijving die zegt wat de Skill is, niet wanneer je die moet gebruiken. "Een deskundige copywriter" wordt nooit geactiveerd. "Schrijft tekst voor productpagina's op basis van een lijst met functies wanneer de gebruiker om een productbeschrijving, PDP-tekst of listingtekst vraagt" wel.
  • Eén Skill voor een hele afdeling. Begroting, salarisadministratie en audit in één bestand leveren je drie halve antwoorden op. Maak drie Skills.
  • Geen uitvoerformaat. Zonder format ziet elke uitvoering er anders uit en vertrouwt niemand het resultaat.
  • Geheimen in het bestand. Plak nooit API-sleutels, wachtwoorden of klantgegevens in een Skill. Iedereen met wie je de Skill deelt, kan deze lezen.
  • Iemands anders Skill installeren zonder deze te lezen. Een Skill bestaat uit instructies die Claude zal volgen, soms met scripts. Lees deze zoals je een script zou lezen voordat je het uitvoert.

Laat Claude het eerste concept voor je schrijven

Je hoeft niet met een leeg bestand te beginnen. Claude kan je over de taak interviewen, de frontmatter en workflow opstellen, een voorbeeldoutput genereren en de bovenstaande testprompts voorstellen. Anthropic levert hiervoor een ingebouwde skill-creator Skill mee, en je kunt ook in gewone woorden vragen: "Interview me over hoe ik ons wekelijkse klantverslag schrijf en schrijf er vervolgens een SKILL.md voor." Je zult het concept moeten bewerken, vooral de beschrijving en de regels, maar het neemt het meeste typwerk uit handen.

Liever een formulier dan een chat? De gratis Claude Skill Builder zet een korte taakbeschrijving om in een kant-en-klare SKILL.md met frontmatter en workflow, die je kunt kopiëren of als .zip kunt downloaden voor Claude.ai en Claude Code. Aanmelden is niet nodig.

Wil je dat het interview, de zelftest en het verpakken voor je worden gedaan? Claude Skill Creator ($19) is een Skill die Skills bouwt: deze vraagt naar de taak, de verzoeken die mensen daadwerkelijk typen en wat er nooit mag gebeuren, schrijft een volledige Skill-map met de SKILL.md en een voorbeeldoutput, test de beschrijving met verzoeken die de Skill wel en niet mogen activeren en verpakt de map voor Claude, Claude Code en de API. Gebruik de Claude Skill Reviewer & Security Linter om een Skill die je zelf hebt geschreven of gedownload te controleren, of neem beide, plus Skills voor prompt-, MCP- en codereview, in de Build Your Own Claude Skills Kit ($49).

Zelf bouwen of beginnen met een kant-en-klare Skill?

Bouw er zelf een wanneer de workflow uniek is voor je team, wanneer deze interne kennis bevat die niemand buiten het team heeft, of wanneer je het leuk vindt om te blijven verbeteren. Begin met een kant-en-klare Skill wanneer het om een standaardfunctie gaat (boekhouding, SEO-briefings, contractbeoordeling, supportreacties) en je de middag liever aan het werk besteedt dan aan instructies. Een kant-en-klare Skill uit onze Claude Skills-bibliotheek kost $19, bevat een voorbeeldoutput en is een gewoon Markdown-bestand dat je kunt openen en bewerken, waardoor het ook als starttemplate voor je eigen versie werkt.

Hoe dan ook is de volgende stap hetzelfde: kies één taak die je elke week herhaalt, schrijf de twee zinnen uit stap 1 en zorg dat je vóór het einde van de dag een werkende Skill hebt.

Veelgestelde vragen

Do I need to know how to code to create a Claude skill?+

No. A skill is a Markdown file with a short header containing a name and a description, followed by instructions in plain language. Scripts are optional and only needed when a step must be computed exactly, such as parsing a file.

What is the minimum a Claude skill needs?+

One folder containing a file named SKILL.md. The file must start with YAML frontmatter that has a name (lowercase letters, numbers and hyphens) and a description of up to 1,024 characters. Everything after that is your instructions.

Why does my Claude skill never trigger?+

Almost always because of the description. Claude reads only the name and description of each installed skill to decide whether to load it. Rewrite the description to lead with the deliverable and include the exact words people use when they ask for that task.

How do I install a skill I created?+

In Claude on the web or desktop, zip the skill folder and upload it in the skills section of your settings, then switch it on. In Claude Code, place the folder in ~/.claude/skills/ for all projects or .claude/skills/ inside a repository. Code execution must be enabled on your account.

Can Claude write a skill for me?+

Yes. Anthropic provides a built-in skill-creator skill, and you can also ask Claude to interview you about a task and draft the SKILL.md. Treat the draft as a starting point and edit the description, rules and example output yourself before relying on it.