Claude Skills maken in Cowork en Claude Code: de handleiding

Claude Skills maken: wat het is en hoe je begint

Als je Claude wat vaker gebruikt, ken je het patroon wel. Je vraagt om een offerte en krijgt iets bruikbaars terug, maar niet in jullie opbouw. Dus leg je uit hoe jullie het doen. De week erna doe je dat weer. En de week daarna nog een keer.

Daar zijn skills voor. Je legt één keer uit hoe iets bij jou werkt, je zet dat in een mapje, en vanaf dat moment weet Claude het. Geen prompt die je elke keer moet opzoeken en plakken.

Wij draaien er inmiddels 29 op kantoor, van het opstellen van facturen tot het opzetten van een SEO-project. Hieronder wat een skill precies is, hoe je er in tien minuten zelf een maakt, en wat het verschil is tussen een skill die werkt en eentje die blijft liggen.

In het kort:

• Een skill is een map met daarin één bestand: SKILL.md. Daar staat in wat het doet, wanneer Claude het moet gebruiken, en hoe jij het aanpakt.
• Je schrijft het gewoon in het Nederlands. Er komt geen code aan te pas, tenzij je dat zelf wilt.
• Alleen de naam en de beschrijving staan altijd geladen. De rest leest Claude pas als de taak erom vraagt, dus twintig skills kosten je niets.
• Het werkt in Cowork, in de Claude-apps en in Claude Code. Alleen de plek waar je het bestand neerzet verschilt.
• Hang je er een koppeling aan met je website of applicatie, dan voert Claude het werk daar ook echt uit in plaats van het alleen op te schrijven.
• Begin bij iets wat je deze maand drie keer hebt uitgelegd. Dat is bijna altijd de beste eerste skill.

In dit artikel:

• Wat een skill precies is
• Wanneer je er een maakt
• Je eerste skill in tien minuten
• Waar je ‘m neerzet in Cowork, Claude Code en de API
• Wat een goede skill onderscheidt van een slechte
• Wat wij er zelf mee doen
• Skills op je eigen website of applicatie
• De fouten die iedereen maakt
• Waar je verder leert

Wat een skill precies is

Een skill is een mapje met een bestand erin, en dat bestand heet SKILL.md. Bovenin staan twee dingen: een naam en een beschrijving. Daaronder staat in gewone taal hoe jij wilt dat iets gebeurt.

Het belangrijkste om te snappen is hoe Claude ermee omgaat. Bij de start leest ‘ie alleen van elke skill de naam en de beschrijving. Meer niet. Pas als je iets vraagt waar een beschrijving bij past, opent ‘ie het hele bestand. Heb je in die skill nog verwezen naar een tweede bestand met bijvoorbeeld je tarieven, dan wordt dat pas gelezen als het echt nodig is.

Dat klinkt als een detail, maar het is precies waarom skills werken en een lange systeemprompt niet. Je kunt er twintig hebben zonder dat het in de weg gaat zitten. Claude pakt wat ‘ie nodig heeft en laat de rest liggen.

Het tweede verschil met een prompt: je hoeft ‘m niet aan te roepen. Je vraagt gewoon om een offerte, en Claude ziet zelf dat daar een skill voor is. Dat lukt alleen als je beschrijving klopt, en daar komen we zo op terug.

Wanneer je er een maakt

Niet elke taak verdient een skill. De vuistregel die bij ons goed werkt: als je iets voor de derde keer aan het uitleggen bent, schrijf het dan op.

Goede kandidaten hebben meestal deze kenmerken:

• Het komt regelmatig terug. Een offerte, een weekrapportage, een blog, het bijwerken van een klantdossier.
• Er zit een vaste werkwijze in. Niet noodzakelijk vastgelegd, maar wel iets wat jij in je hoofd hebt en collega’s niet.
• De uitkomst moet consistent zijn. Elke offerte dezelfde opbouw, elke factuur hetzelfde format.
• Er zitten regels in die je snel vergeet. “Altijd exclusief btw vermelden”, “nooit publiceren zonder tweede check”. Dat soort dingen.

Slechte kandidaten zijn taken die je één keer doet, of taken waarbij elke situatie zo anders is dat er geen patroon in zit. Daar heb je meer aan een goed gesprek dan aan een instructie.

Je eerste skill in tien minuten

Neem iets kleins. Wij pakken hier een offerte, maar vul in wat bij jou past.

Stap 1. Doe de taak eerst gewoon een keer met Claude. Zonder skill, gewoon in een gesprek. Let op wat je onderweg allemaal moet uitleggen: onze opbouw, onze tarieven, dat we altijd een geldigheidsduur noemen. Dat wat je uitlegt, dát wordt je skill.

Stap 2. Vraag Claude om er een skill van te maken. Letterlijk: “maak hier een skill van, met onze opbouw en de regel over btw.” Claude kent het formaat en schrijft ‘m voor je. Je hoeft de syntax niet uit je hoofd te leren.

Stap 3. Gooi eruit wat Claude al weet. Dit is de stap die de meeste mensen overslaan. Uitleggen wat een offerte is, is zonde van de ruimte. Alleen wat specifiek voor jou geldt hoort erin.

Stap 4. Zo ziet het resultaat eruit:

---
name: offerte-opstellen
description: Stelt een offerte op volgens de vaste opbouw en tarieven van het
  bureau. Gebruik dit wanneer iemand vraagt om een offerte, prijsopgave of
  calculatie voor een nieuw project.
---

# Offerte opstellen

## Vaste opbouw
1. Wat we begrepen hebben van de vraag
2. Wat we gaan bouwen, per onderdeel
3. Wat er niet in zit
4. Investering en doorlooptijd

## Regels
- Nooit een totaalprijs zonder uitsplitsing
- Altijd een geldigheidsduur van 30 dagen
- Bedragen exclusief btw, en dat er expliciet bij vermelden

Stap 5. Test ‘m op een echte klus. Niet op een verzonnen voorbeeld. Vraag om een offerte voor een klant die morgen op de agenda staat en kijk of Claude de skill pakt en de regels volgt. Doet ‘ie dat niet, dan ligt het bijna altijd aan de beschrijving.

Waar je 'm neerzet

De inhoud is overal hetzelfde, alleen de plek verschilt per omgeving.

• Claude Cowork en de Claude-apps. Stop je map in een zip-bestand, met de map er nog omheen, en upload ‘m onder Customize en dan Skills. Daarna nog even aanzetten. Let erop dat de mapnaam gelijk is aan de naam in je bestand.
• Claude Code. Hier hoeft geen zip aan te pas te komen. Zet de map in ~/.claude/skills/ en klaar. Bij ons staat die map in een gedeelde Drive-map met een snelkoppeling ernaartoe, zodat we op twee laptops dezelfde skills hebben.
• De API. Daar werkt het via de code execution tool.

Voor alle drie geldt dat code execution aan moet staan. Skills werken op de gratis versie en op alle betaalde abonnementen.

Nog een handige: in Cowork op de Mac kun je een skill opnemen. Je zet de opname aan, doet de klus één keer voor, en Claude schrijft er zelf een skill van. Dat gaat tot ongeveer tien minuten en werkt op Pro, Max en Team. Voor mensen die liever iets voordoen dan opschrijven is dat de kortste route.

Wat een goede skill onderscheidt van een slechte

Het verschil zit bijna nooit in de inhoud. Het zit in de beschrijving en in de lengte.

De beschrijving is het halve werk. Dat is het enige wat Claude ziet als ‘ie moet kiezen. Zet er dus in wát de skill doet én wanneer je ‘m gebruikt, en schrijf ‘m in de derde persoon. “Stelt een offerte op volgens de vaste opbouw. Gebruik dit wanneer iemand vraagt om een offerte, prijsopgave of calculatie” werkt. “Helpt met documenten” werkt niet, want daar kan Claude niets mee.

Kort is beter. De richtlijn van Anthropic zelf is: houd het onder de 500 regels. Wordt het langer, splits het dan op in losse bestanden waar je vanuit je hoofdbestand naar verwijst. Claude leest die pas als het nodig is.

Verwijs één laag diep. Een bestand dat verwijst naar een bestand dat weer verwijst naar een bestand gaat mis. Alles wat je nodig hebt link je rechtstreeks vanuit je hoofdbestand.

Geen datums en versies die verlopen. “Vanaf september gebruiken we het nieuwe tarief” is over drie maanden gewoon fout. Zet het actuele tarief erin en pas het aan als het verandert.

Eén woord voor één ding. Als je het de ene alinea een offerte noemt en de volgende een prijsopgave, moet Claude gaan raden. Kies er één.

Geef één manier, niet vijf. Opsommen dat het zus of zo of ook nog anders kan, maakt de uitkomst wisselvallig. Kies de manier waarop jij het wilt.

Wat wij er zelf mee doen

Een paar uit onze eigen map, zodat je een idee krijgt van het soort klussen dat zich ervoor leent:

• Facturatie voor een klant met eigen regels. Die klant weigert facturen zonder inkoopnummer vóór de dienstnaam. Dat is precies zo’n regel die je één keer vergeet en dan twee weken later terugkrijgt. Staat nu in een skill, samen met wat er moet gebeuren als een mail niet te matchen is.
• Werk inplannen in onze projectadministratie. Inclusief de capaciteitscheck: zit iemand al boven de 75 procent, dan gaat er niets meer bij. Bij deze skill zit een los Python-script, want die berekening wil je niet elke keer opnieuw laten uitrekenen.
• Blogs schrijven in onze eigen stijl. Ja, ook deze. Daarin staat waar onze teksten aan moeten voldoen en welke AI-stijlfratsen eruit moeten.
• Een SEO-project opzetten. De vaste volgorde van zoekwoordonderzoek, concurrenten en rapportage, zodat elk project hetzelfde begint.

Wat ze gemeen hebben: het zijn geen indrukwekkende AI-toepassingen. Het is opgeschreven werkwijze. Precies het soort kennis dat normaal in iemands hoofd zit en verdwijnt als die persoon op vakantie is.

Skills op je eigen website of applicatie

Tot hier ging het over werk dat in documenten zit. Skills worden pas echt interessant als Claude erbij kan in het systeem waar je werk in staat: je WordPress-site, je webshop of je eigen applicatie.

De skill beschrijft dan de werkwijze en de koppeling geeft Claude handen. Zo’n koppeling heb je vaak al liggen. WordPress heeft een REST API, de meeste applicaties hebben er ook één, en anders zet je er een MCP-server of een klein script naast dat gewoon in de map van de skill staat.

Het soort klussen dat daarmee weggaat:

• Driehonderd productteksten in een webshop bijwerken, met de schrijfstijl en de verplichte velden vastgelegd in de skill.
• Een nieuwe locatiepagina opbouwen volgens hetzelfde stramien als de veertig die er al staan, inclusief interne links en meta-omschrijving.
• Elke maandag dezelfde rapportage uit de applicatie trekken, met dezelfde kolommen en dezelfde toelichting eronder.
• Een stapel oude blogs nalopen op dode links en verlopen prijzen, en de correcties als concept klaarzetten.

Twee dingen leg je daarbij vast in de skill zelf. Ten eerste wat er niet mag: niets publiceren zonder tussenstap, niets weggooien, bij twijfel stoppen en het vragen. Ten tweede waar ‘ie mag werken. Begin op staging of met alleen leesrechten, en ga pas naar live als je een paar keer hebt gezien dat de uitkomst klopt.

De werkwijze opschrijven kan iedereen die het werk doet. De koppeling en de rechten eromheen zijn techniek, en daar loopt het meestal vast. Dat stuk bouwen wij op websites en webapplicaties, met de skill erbij, zodat het team daarna zelf verder kan.

De fouten die iedereen maakt

• Een vage beschrijving. Veruit nummer één. De skill is prima, maar Claude pakt ‘m nooit omdat er “helpt met teksten” staat. Werkt je skill niet, kijk hier dan als eerste.
• Uitleggen wat Claude al weet. Drie alinea’s over wat een offerte is. Zonde van de ruimte en het leidt af van de regels die er wél toe doen.
• Alles in één bestand proppen. Een skill van 1.200 regels met je complete prijslijst erin. Splits die prijslijst af naar een apart bestand.
• Testen op een verzonnen voorbeeld. Werkt altijd. Zegt niets. Test op echt werk.
• Nooit meer terugkijken. Een skill is geen document dat je af hebt. Merk je dat Claude iets structureel anders doet dan je bedoelde, pas de skill dan aan. Dat is meestal één regel.

Waar je verder leert

Anthropic heeft zijn eigen uitleg inmiddels op orde en die is gratis. Op Claude Academy staan korte cursussen met video’s en een quiz aan het eind.

• Introduction to agent skills, zes lessen van bij elkaar ongeveer een uur. Dat is de kortste route na dit artikel.
• Introduction to Claude Cowork en Claude Code 101, als je nog moet kiezen waar je gaat werken.
• Introduction to Model Context Protocol, voor het koppelen aan je eigen systemen.

Alles in het Engels, en je haalt er een badge mee op als je dat bijhoudt. Wie liever meteen doorpakt op de techniek: er staat ook een volledige cursus over bouwen met de Claude API van negen uur.

Waar te beginnen

Pak iets wat je deze maand al drie keer hebt uitgelegd. Doe die taak één keer samen met Claude, vraag om er een skill van te maken, haal eruit wat overbodig is en test ‘m op echt werk. Een half uur, en je hebt ‘m.

Loopt het werk dat je wilt automatiseren via je website, je webshop of je eigen applicatie, dan komt daar een koppeling bij kijken en wordt het bouwwerk. Dat doen wij. Wil je eerst even sparren over waar bij jullie de meeste tijd in gaat zitten, plan dan een adviesgesprek.