Claude Code skills maken: een vaste aanpak voor terugkerend werk

Met een skill bewaar je een terugkerende werkwijze. Voor dit voorbeeld starten we haar zelf met /schermtekst-nalopen.

Ik zou beginnen met een taak die je zelf goed kunt beoordelen. Hieronder maken we een skill voor het nalopen van schermteksten in een app. Die helpt om knoppen, foutmeldingen en bevestigingen als één geheel te bekijken. Het voorbeeld gaat over een inschrijfformulier; je kunt de aanpak aanpassen aan je eigen project.

Stel dat verschillende mensen aan een inschrijfapp werken. Op de knop staat “Verzenden”, na een fout verschijnt “Registratie mislukt” en in de bevestiging heet dezelfde actie “Aanmelden”. Iedere tekst kan op zichzelf begrijpelijk zijn, terwijl het scherm als geheel onrustig wordt.

Een vaste redactieaanpak helpt dan. Je wilt steeds weten: welke handeling doet de gebruiker, hoe noemen we die handeling en wat moet iemand kunnen doen als het misgaat? Dat zijn inhoudelijke keuzes. De skill maakt ze vindbaar voor de volgende taak.

Schrijf eerst op wat je als uitkomst wilt zien. In dit geval is dat een voorstel met de bestaande tekst, de nieuwe tekst en de reden voor de wijziging. Daarmee kun je een voorstel beoordelen voordat iemand onderdelen in de app aanpast.

Volgens de Claude Code-documentatie bestaat een skill uit een map met een bestand SKILL.md. Bovenaan staan eigenschappen zoals de naam en beschrijving, daaronder de instructies. Voor dit voorbeeld maak je in je project het bestand .claude/skills/schermtekst-nalopen/SKILL.md met deze eigen voorbeeldtekst:

De stappen verwijzen naar het werk dat je wilt laten doen. De tabel maakt de uitkomst bespreekbaar. De laatste regel over broncode en schermcontrole helpt om te zien welk bewijs bij het voorstel hoort.

Projectskills staan in .claude/skills; persoonlijke skills in ~/.claude/skills. Voor de schermteksten delen we de projectskill met het team.

Mijn voorkeur is om een gedeelde skill te laten nalopen door iemand die de taak ook uitvoert. Begrijpt een collega onder “bruikbare vervolgstap” hetzelfde als jij? Een voorbeeld van een goede foutmelding kan meer verduidelijken dan vijf algemene regels over duidelijke taal.

Start de voorbeeldskill in Claude Code met /schermtekst-nalopen en wijs het relevante scherm aan. Geef bestaande schrijfafspraken mee, zoals de gewenste aanspreekvorm en de naam van de aanmeldactie. Door disable-model-invocation: true in dit voorbeeld start je deze skill zelf.

Neem vervolgens drie situaties door: een leeg formulier, ongeldige invoer en een geslaagde aanmelding. Bekijk of het voorstel in alle drie de situaties dezelfde woorden gebruikt. Een vriendelijkere melding mag de oorzaak van de fout niet onduidelijk maken.

Laat ook een twijfelgeval zien. “Aanmelding ontvangen” en “Je plek is bevestigd” betekenen niet hetzelfde. Als de plek pas na een beoordeling definitief is, mag de skill dat verschil niet wegschrijven. Ontbreekt die informatie, dan hoort er een vraag te komen.

Een eerste proef laat vaak zien waar de werkwijze te algemeen is. Stel dat de skill alle knopteksten wil inkorten, ook als daardoor de betekenis verandert. Voeg dan een gerichte regel toe: de gebruiker moet vóór het klikken begrijpen welke actie volgt.

Herhaal daarna dezelfde oefening. Zo zie je of je wijziging het probleem oplost. Geef ook een taak die niet bij de skill hoort, bijvoorbeeld het onderzoeken van een databasefout. Je wilt dat de redactieprocedure gericht blijft op schermteksten.

Maak de skill groter wanneer een terugkerend probleem daarom vraagt. Een lange lijst uitzonderingen voor situaties die nooit voorkomen, maakt de aanpak moeilijker te onderhouden.

Een skill beschrijft gewenst gedrag. De toegangsinstellingen van Claude Code bepalen welke handelingen technisch mogelijk zijn. Voor het beoordelen van schermtekst hoeft deze oefening geen productiegegevens te lezen of een publicatie te starten.

Wil je later wel wijzigingen laten uitvoeren, maak daar een concrete vervolgstap van. Laat de bestaande tekstvoorstellen toepassen, bekijk het scherm en controleer het gedrag. Een tekstwijziging kan bijvoorbeeld meer ruimte vragen op mobiel. Neem die controle mee in de oplevering.

Skills bouwen voort op de Agent Skills-standaard. Productspecifieke instellingen, zoals de manier waarop een skill wordt gestart, moet je wel controleren in de documentatie van de tool die je gebruikt. Een map kopiëren is nog geen bewijs dat de hele werkwijze daar hetzelfde werkt.

Begin met één goede procedure en wijs een eigenaar aan. Werk de skill bij wanneer de app, terminologie of manier van opleveren verandert. Zo bouw je een bibliotheek die bij je werk blijft passen.

Meer achtergrond vind je bij Claude Code skills en in de complete handleiding voor Claude Code. In Claude Code voor gevorderden verbind je zulke werkwijzen met agents, MCP en je eigen ontwikkelproces.