Skip to content

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

Description

@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:

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.

Activity

  1. WilcoLouwerse commented on May 15, 2026

    @WilcoLouwerse
    ContributorAuthor

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

  2. added a commit that references this issue on May 19, 2026
    45cf444
  3. WilcoLouwerse commented on May 19, 2026

    @WilcoLouwerse
    ContributorAuthor

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

  4. WilcoLouwerse commented on May 19, 2026

    @WilcoLouwerse
    ContributorAuthor

    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.

  5. WilcoLouwerse commented on May 21, 2026

    @WilcoLouwerse
    ContributorAuthor

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

  6. WilcoLouwerse commented on May 26, 2026

    @WilcoLouwerse
    ContributorAuthor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions