Agent Skills & SKILL.mdGeplaatst door martijn.b194 dagen geleden

Custom SKILL.md schrijven: complete guide

Ik ben de afgelopen weken flink aan het experimenteren geweest met custom skills voor Claude en wil mijn learnings delen. Een SKILL.md is eigenlijk een instructieset dat Claude vertelt hoe het een specifieke taak moet uitvoeren. Denk aan het als een super-gedetailleerde briefing die je aan een nieuwe medewerker zou geven. Het mooie is: als je het goed schrijft, kan Claude taken consistent en op hoog niveau uitvoeren. Mijn aanpak in het kort: 1. Begin met een duidelijke trigger-beschrijving (wanneer moet deze skill activeren?) 2. Definieer de exacte stappen die Claude moet volgen 3. Voeg voorbeelden toe van gewenste output 4. Specificeer wat NIET mag (constraints) 5. Test, itereer, test opnieuw De grootste fout die ik zie: mensen schrijven te vage instructies. "Maak een goede blogpost" werkt niet. "Schrijf een blogpost van 800-1200 woorden in informele Nederlandse toon, met H2 headers elke 200 woorden, gericht op [doelgroep], met een CTA onderaan" werkt wél. Heeft iemand hier ervaring met het stacken van meerdere skills? Ik wil een workflow bouwen waarbij de ene skill de output van de andere gebruikt.
8
💬 5 reacties🔗 Delen

Reageer

floris_91193 dagen geleden

Eindelijk iemand die dit goed uitlegt! Die tip over specifieke instructies vs vage prompts is zo belangrijk. Ik heb zelf een skill geschreven voor code reviews en het verschil tussen versie 1 (vaag) en versie 5 (specifiek) is dag en nacht.

noah_tech192 dagen geleden

Ik ben precies met dit bezig! Vraag: hoe ga je om met edge cases? Mijn skill werkt 90% van de tijd perfect maar bij onverwachte input gaat het mis. Heb je een strategie voor robuuste error handling in een SKILL.md?

martijn.b190 dagen geleden

Goede vraag! Mijn strategie: voeg een "fallback" sectie toe aan je SKILL.md. Iets als: "Als de input niet voldoet aan het verwachte format, vraag de gebruiker om verduidelijking in plaats van te gokken." Werkt verrassend goed, Claude is heel goed in het herkennen van ambiguïteit als je het expliciet maakt.

daan.s191 dagen geleden

Die 5-stappen aanpak ga ik overnemen. Vooral het punt over constraints — ik had nooit expliciet opgeschreven wat de skill NIET moet doen en daardoor kreeg ik soms compleet verkeerde output. Simpele toevoeging maar groot effect.

james_vmc189 dagen geleden

Sterke guide! Dit is precies waar vibe skills om draait — gestructureerd je kennis vastleggen zodat AI het consistent kan toepassen. Tip: voeg ook een sectie toe met "voorbeelden van goede output" zodat de skill weet waar het naartoe werkt. Dat maakt het verschil.