TUTORIAL | Claude Skills — wat zijn ze en hoe schrijf je er een

[WilcoLouwerse]

Achtergrond

Claude Skills zijn het mechanisme waarmee we Claude Code en onze interne agents uitbreiden met herbruikbare, gespecialiseerde gedragingen (bv. /review-pr, /opsx-new, alle hydra-gate-* skills). Voor nieuwe medewerkers en partners is de drempel om een skill te schrijven of aan te passen nu hoog, omdat de documentatie verspreid staat en er geen instaproute is.

Doel

Een Nederlandstalige, publieke tutorial op conduction.nl/academy die uitlegt wat Claude Skills zijn, hoe je er een schrijft, en hoe je hem test. Bij voorkeur opgesplitst in een korte introductie + een doe-tutorial.

Doelgroep

Developers en power-users die Claude Code dagelijks gebruiken en eigen workflows willen automatiseren.

Voorgestelde structuur (chaining)

1. Wat zijn Claude Skills? — concept, wanneer skill vs. gewone prompt, frontmatter, triggering, verschil met commands. Linkt door naar 2.
2. Je eerste skill schrijven — skill-creator gebruiken, schrijven, lokaal testen, opnemen in de skill-registry.
3. (optioneel) Skill-evals — hoe meet je of een skill goed werkt.

Bestaande documentatie (referenties)

In /home/wilco/.github/docs/claude/ staat al ruim materiaal:

• docs/claude/writing-skills.md
• docs/claude/skill-patterns.md
• docs/claude/skill-checklist.md
• docs/claude/skill-evals.md
• docs/claude/commands.md
• Bestaande skills in .claude/skills/ als concrete voorbeelden.

Pluvo-vragen (minimaal 4)

Voorbeelden:

1. Wat is het verschil tussen een skill en een command in Claude Code?
2. Welke velden zijn verplicht in de frontmatter van een skill, en wat doen ze?
3. Hoe weet Claude wanneer hij een skill moet triggeren — wat staat er in de description?
4. Hoe test je een skill voordat je hem deelt met het team?
5. Wanneer is het beter om een gewone prompt te schrijven dan een skill?

Op te leveren

• Tutorial(s) in MDX op ConductionNL/conduction-website onder academy/
• Concrete code-voorbeelden (één werkende mini-skill)
• Minimaal 4 Pluvo-vragen per deel
• Cross-links naar Workstation Setup, OpenSpec, Hydra-leerlijn
• Linkcheck
• Peer review

Schrijfstijl

Volg de Conduction-schrijfstijl (zie identity.conduction.nl). Voorbeeldstructuur: Bestanden bij een Woo-publicatie uploaden. Liever twee korte dan één lange.

Tijdregistratie

Uren op dit issue boeken op de Jira-issue van het SLIM-account.

[WilcoLouwerse]

Korte update — branch tutorial/claude-skills-leerlijn klaar met drie gechaineerde Nederlandstalige modules (concept → eerste skill → evals). PR open: ConductionNL/conduction-website#46 (closes deze issue).