De derde chat begint weer met dezelfde uitleg: welke details horen in de briefing, welke termen gebruikt het team en wat moet er gebeuren als er iets ontbreekt? Herhaling is een goed teken dat je een werkwijze kunt vastleggen. Een skill maakt daar een herbruikbare instructie van die je bewust toepast en blijft onderhouden.
Voor Claude Code beschrijft de officiële skills-documentatie een SKILL.md met metadata en instructies. Die kan worden gebruikt wanneer een taak erbij past of wanneer je hem expliciet aanroept. Dit verandert de instructie voor het werk, niet de getrainde modelgewichten. De bestanden hieronder zijn ons eigen illustratieve ontwerp, geen verslag van een uitgevoerde run.
Eerst de beslissing, dan het bestand
Ons voorbeeld is een maandelijkse repaircafé-avond. Uit organisatorische notities moet een interne briefing worden gemaakt. Daarin hebben de helpers de bevestigde afspraken, de taken en de openstaande beslissingen nodig. Dat is een kleinere opdracht dan het plannen van het hele evenement.
Leg vooraf een invoercontract vast. Elk detail heeft een waarde en een status nodig. “Start 18:00, bevestigd” is iets anders dan “Start 18:00, voorstel”. De AI moet dat verschil behouden. Als de locatie ontbreekt, is dat een open vraag; een aannemelijk klinkend vervangend adres zou de opdracht ondermijnen.
Houd de SKILL.md kort en eenduidig
Een mogelijke locatie op projectniveau is .claude/skills/reparaturbrief/. Daarin zou de volgende eigen werkinstructie kunnen staan. De metadata legt uit wanneer die nodig is; de tekst daaronder beschrijft wat die moet opleveren.
---
name: reparaturbrief
description: Creates internal briefings for repair evenings from organisational notes.
---
Record confirmed details and suggestions separately.
Do not invent venues, dates, names or commitments.
If there are contradictions: state both details and phrase a follow-up question.
Output:
1. Confirmed arrangements
2. Tasks with confirmed responsibility
3. Open decisions with a reference to the input
4. Next coordination stepEen beschrijving als “helpt bij alles wat met organisatie te maken heeft” zou minder zeggen. Daardoor is moeilijk te zien waar de skill past en wanneer een andere werkwijze geschikt is. Een duidelijke grens maakt later onderhoud ook makkelijker.
Een voorbeeldoverdracht met een echt gat
Gebruik kunstmatige notities: de ruimte is bevestigd, de begintijd is nog maar een voorstel, en materialen worden pas besteld zodra het budget is goedgekeurd. Benoem deze voorwaarden direct. Een verwachte uitvoer mag een taak “Budget verduidelijken” bevatten. “Materialen besteld” zou daarentegen een nieuwe, niet-onderbouwde bewering zijn.
Een nuttige aanvullende instructie luidt: “Geef bij elke openstaande beslissing aan welk deel van de invoer die oproept.” Zo ontstaat een verband tussen het gat en de bron ervan. De skill hoeft niet de hele oorspronkelijke tekst te herhalen; hij moet het betwiste detail makkelijk vindbaar maken.
Houd een stilistische voorkeur gescheiden van de inhoudelijke regels. Een voorbeeld van korte taakbeschrijvingen kan als ondersteunend bestand dienen. Evenementdetails die vaak veranderen, horen daarentegen in de afzonderlijke opdracht. Zo raakt de algemene instructie niet verouderd bij de volgende datum.
Drie gevallen brengen verschillende zwakke plekken aan het licht
In het eerste geval lever je volledige, consistente details aan. In het tweede ontbreekt de datum en spreken twee budgetnotities elkaar tegen. In het derde vraag je om iets buiten het terrein van de skill, zoals reisplanning. Zo kun je structuur, omgang met onzekerheid en de grenzen van het gebruik afzonderlijk bekijken.
Noteer per geval wat absoluut behouden moet blijven. Beoordeel een antwoord eerst daarop en pas daarna op stijl. Elegante formuleringen maken een verzonnen datum niet goed. Evenmin is een vervolgvraag een fout als precies die beslissing in de invoer ontbreekt.
Een kleine werkinstructie onderhouden
Als een probleem terugkeert, wijzig je één specifieke regel en herhaal je de bestaande gevallen. Voeg een nieuw geval toe dat nog niet bekend was toen de wijziging werd geschreven. Zo zie je makkelijker of de regel alleen één enkel voorbeeld nabootst.
Leg de reden voor de wijziging en de status ervan vast. In het begin is daar geen grote infrastructuur voor nodig. Een korte notitie als “Budgetvoorwaarden moeten in de takenlijst behouden blijven” is makkelijker te volgen dan een volledige herschrijving zonder reden. Een skill is de moeite waard als de regels ervan de volgende echte overdracht begrijpelijker maken.
Bronnen en documentatiestatus: 25 oktober 2026.
