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).

[WilcoLouwerse]

PR is ondertussen gemerged, nu nog naar main mergen en in Pluvo plaatsen

[WilcoLouwerse]

Status update — PR open 📣

De Claude Skills leerlijn staat klaar voor review: ConductionNL/conduction-website#73.

Wat is opgeleverd

Vier delen (oorspronkelijke scope was 2-3; deel 4 is later toegevoegd om L6/L7-maturity te dekken):

1. Wat zijn Claude Skills — concept, frontmatter, progressive disclosure, triggering, verschil t.o.v. plain prompts.
2. Je eerste skill schrijven — scaffolden met /skill-creator, goede description schrijven, lokaal testen, opnemen in de registry.
3. Skill-evals (L5 meet-fundering) — hoe je meet of een skill werkt voordat je hem groter maakt.
4. L6 self-improvement + L7 orchestration — learnings.md, de Capture Learnings-stap, multi-agent orkestratie, en het skill-level-overview dashboard.

Op te leveren — afgevinkt

• Tutorial(s) in MDX onder academy/ (vier delen)
• Concrete code-voorbeelden (werkende mini-skill in deel 2, learnings-loop in deel 4)
• Minimaal 4 Pluvo-vragen per deel — als collapsible "Test jezelf"-blocks met Hint + Antwoord
• Cross-links naar /academy peers en de Conduction-docs (writing-skills.md, skill-patterns.md, etc.)
• Linkcheck — handmatig gelopen, public links OK; één interne Hydra-link in deel 4 verwijderd voor de publieke versie
• Peer review — afwachten op PR ci(documentation): run build/validate on PRs, deploy only on push #73

Branch-strategie

De leerlijn is afgesplitst van de interne Hydra-leerlijn (tutorial/hydra-leerlijn-intern), waardoor PR #73 alleen de publieke Skills-content naar development brengt. De interne Hydra-tutorials blijven op de interne branch tot die apart wordt gemerged.

Closes via PR #73.

[WilcoLouwerse]

PR #73 is vandaag gemerged in development — nu nog naar main mergen en in Pluvo plaatsen.

[WilcoLouwerse]

ConductionNL/conduction-website#118