Agent Skills & SKILL.mdGeplaatst door kai.m191 dagen geleden

Claude Code SKILL.md: van simpel naar professioneel

Ik bouw al 3 maanden SKILL.md files voor Claude Code en heb een hoop geleerd over wat werkt en wat niet. Een basis SKILL.md ziet er zo uit: ```markdown # Skill: Blog Generator ## Doel Genereer SEO-geoptimaliseerde blogposts ## Input - Keyword, doelgroep, tone of voice ## Stappen 1. Outline maken 2. Per sectie schrijven 3. Meta description toevoegen ``` Maar een professionele SKILL.md gaat veel verder: - Concrete voorbeelden van gewenste output - Foutafhandeling (wat als input ontbreekt) - Constraints (max lengte, verplichte elementen) - Quality checks die de skill zelf uitvoert - Variatie-instructies zodat output niet repetitief wordt Mijn beste tip: schrijf je SKILL.md alsof je een junior collega instrueert. Hoe specifieker, hoe beter het resultaat. Ik heb een skill die product reviews schrijft en die haalt nu consistent 8/10 kwaliteit omdat ik er 2 uur aan besteed heb om de instructies perfect te maken. De investering in een goede SKILL.md betaalt zich 100x terug als je hem dagelijks gebruikt.
12
💬 5 reacties🔗 Delen

Reageer

martijn.b190 dagen geleden

Die tip over voorbeelden van gewenste output is cruciaal. Ik merkte dat mijn skills pas echt goed werden toen ik 2-3 concrete output voorbeelden toevoegde. Claude snapt dan veel beter wat je verwacht.

james_vmc189 dagen geleden

Goede progressie van basis naar pro. In het boek De 4 Prompting Disciplines wordt dit Specification Engineering genoemd - hoe specifieker je specs, hoe consistenter je output. Precies wat je hier laat zien.

kai.m188 dagen geleden

Die term kende ik niet maar het klopt precies. Ga dat boek eens bekijken, klinkt als de theorie achter wat ik in de praktijk heb ontdekt.

joost.vdm188 dagen geleden

Ik gebruik nu 12 SKILL.md files dagelijks. De truc die jij noemt over alsof je een junior instrueert is exact hoe ik het ook aanpak. Works every time.

yorick_dev187 dagen geleden

Die quality checks die de skill zelf uitvoert, hoe doe je dat precies? Gewoon een stap toevoegen in de instructies die zegt controleer of X aanwezig is?