academy: public Claude Skills leerlijn (4 chained Dutch tutorials)

[WilcoLouwerse]

Summary

• Adds a public Nederlandstalige leerlijn op /academy over Claude Skills, in dezelfde layout als de Hydra-leerlijn (Outcomes, Prerequisites, Test jezelf quizzes met Details collapsibles, NextSteps, ContactCta).
• Vier korte, gechaineerde modules:
  • Deel 1 — Wat zijn Claude Skills? (concept, frontmatter, triggering, skill vs prompt/command/agent)
  • Deel 2 — Je eerste skill schrijven (werkende git-status-summary mini-skill, /skill-creator, degrees of freedom, dynamic content, lokaal testen)
  • Deel 3 — Skill-evals (7 maturity-levels, evals.json-schema, trigger-tests, baseline-meting, iteratie-cycle) — eindstation L5
  • Deel 4 — Van gemeten naar lerend en orkestrerend (L6 learnings-loop, L7 sub-agent orkestratie, skill-level-overview dashboard)
• Cross-links toegevoegd: Hydra-leerlijn deel 1 noemt de nieuwe Claude Skills-leerlijn als aanbevolen voorkennis, en Hydra-leerlijn deel 4 (Skills) verwijst op meerdere plekken terug. Skills-leerlijn deel 4 linkt terug naar Hydra-leerlijn deel 4 als voorbeeld van een L7-pipeline in de praktijk.
• Legacy "commands"-framing geschoond over Hydra + Skills leerlijnen: hydra-tutorial-4-skills-commands hernoemd naar hydra-tutorial-4-skills, en de slash-command-als-aparte-categorie narrative uit skills tutorial 1 gehaald (commands zijn sinds Anthropic's merge gewoon skills).
• Test jezelf-quizzes nu als collapsible Details blocks ingebouwd; MDX-fix voor <500 in deel 3 (escape zodat MDX het niet als JSX leest).
• Review-fixes uit comment van Mark verwerkt: gates-count consistent op 13 (was 8/14-mismatch in hydra-tutorial-4), 7-level framework expliciet aangekondigd in deel 1, --ignored-guardrail toegevoegd aan git-status-summary, en eerste-persoon-meervoud in narrative weggewerkt waar het wegliep.

Closes ConductionNL/.github#52

Test plan

• docusaurus build lokaal: alle vier de nieuwe Skills-pagina's + de hernoemde Hydra-deel-4 compileren zonder MDX-fouten. (Build faalt op een unrelated pre-existing AtomZones-import in deskdesk-tutorial-1-scaffold op development; geen van de PR-files raakt SSG.)
• Slugs kloppen — interne links /academy/claude-skills-tutorial-{1,2,3,4}-… resolveren naar de juiste pagina's; partNumber 1/2/3/4 consistent in frontmatter.
• Cross-links in Hydra deel 1 + deel 4 openen de juiste Claude Skills-pagina; Skills deel 4 → Hydra deel 4 werkt.
• Quizzes (Details collapsibles) klappen netjes open/dicht.
• Viervoudig-backtick code-block in deel 2 (geneste drievoudige backticks in het SKILL.md-voorbeeld) wordt door MDX-loader probleemloos geparsed.
• Peer-review van de Nederlandse schrijfstijl (Conduction-stijl: liever twee korte dan één lange, derde persoon, action-werkwoorden).
• End-to-end /skill-creator → git-status-summary flow eens daadwerkelijk uitvoeren in Claude Code om te valideren dat de dialoog ("Claude vraagt … antwoord ongeveer zo") aansluit bij wat de huidige skill-creator in de praktijk vraagt.

🤖 Generated with Claude Code

[MWest2020]

Review (Claude, t.b.v. Mark)

Mooie leerlijn — strakke vier-delige opbouw, consistente quizzes, de slug- en partNumber-velden kloppen. Eén concrete fix heb ik er meteen opgezet, plus een lijstje resterende punten voor de auteur.

Gepatcht in e1e4012

De publieke claude-skills-tutorial-4-l6-l7-mature-skills linkte vijf keer naar ConductionNL/hydra — die repo is privé, dus die URLs leveren 404 voor externe lezers. Verwijderd:

• Twee [update-skill-overview.sh](…hydra/blob/main/…)-links en één [skill-level-overview.html](…)-link → vervangen door plain code-references (de inhoud van de uitleg blijft staan).
• De defensieve quote "Hydra is privé, dus daar krijg je een 404" → eruit. Acknowledged een broken state in plaats van die op te lossen.
• De "Kopieer deze twee bestanden naar <jouw-repo>/.claude/skills/"-instructie → vervangen door twee paden: (a) opvragen via de ContactCta die al onderaan de pagina staat, (b) zelf bouwen op basis van de meet-regels in de tabel hierboven.

Net diff: -11 / +9 regels in één file. De Hydra-links in de interne hydra-tutorial-4-skills (unlisted: true) staan er nog — die zijn voor Conduction-collega's met repo-toegang, geen probleem.

Blockers vóór merge

1. PR-titel zegt "4 chained tutorials", de body somt er drie op. Deel 4 (L6 → L7) ontbreekt in de samenvatting; update de description en Closes-line zodat reviewers niet aannemen dat deel 4 per ongeluk is meegekomen.
2. Test-plan checkboxes zijn allemaal leeg, inclusief docusaurus build. Per onze conventie "academy tutorials met shell-commando's moeten end-to-end gedraaid worden vóór PR": minstens deel 2's /skill-creator → git-status-summary flow eens daadwerkelijk uitvoeren. De dialoog ("Claude vraagt … antwoord ongeveer zo") moet kloppen met wat de huidige skill-creator in de praktijk vraagt.
3. Inconsistentie in hydra-tutorial-4-skills (intern). De Reviewer-rij in de container-tabel zegt "hydra-gates + 8 individuele hydra-gate-* skills"; de gates-familie-tabel verderop somt 14 gates op (en de regel onder de tabel zegt "Alle 14 draaien in de Hydra-fabriek"). Eén van de twee getallen klopt niet — verifieer welke Builder/Reviewer/Security daadwerkelijk in hun image hebben en pas aan.

Polish (non-blocking)

• 7-level framework valt uit de lucht in deel 3. Eén regel in deel 1 ("in deel 3 introduceren we een 7-level maturity-framework") helpt de lezer.
• Eerste persoon meervoud slipt door ("we laden ze bij Juan en Clyde", "in onze eigen skill-toolchain"). Memory zegt derde persoon — niet alles streng, maar één consistency-pass.
• Build-risico: viervoudig-backtick code-block in deel 2 (geneste drievoudig-backticks in het SKILL.md-voorbeeld). MDX-renderers struikelen daar soms over. Verifieer met docusaurus build voordat het live gaat.
• git-status-summary voorbeeld: voeg aan de Guardrails toe dat --ignored niet meegegeven mag worden, anders matched de "X is not blank and not ?"-staged-check ook ! (ignored) lines.

Globaal: leerlijn is publicatie-klaar zodra de drie blockers afgehandeld zijn. De polish-punten passen prima in een follow-up.

[WilcoLouwerse]

Dank voor de review @MWest2020 — review-fixes staan in 0ad73bc.

Blockers afgehandeld

1. PR-titel + description — body somt nu alle vier delen op (deel 4 was er inderdaad in 7f91181 bijgekomen maar nooit in de summary opgenomen); Closes ConductionNL/.github#52 blijft staan.
2. Test-plan — checkboxes ingevuld voor wat er daadwerkelijk geverifieerd is (build, slugs, cross-links, quizzes, viervoudig-backtick block). De twee items die handwerk vragen (peer-review Nederlandse stijl + end-to-end /skill-creator → git-status-summary flow in een echte Claude-sessie) staan open in het test-plan zodat ze niet uit beeld verdwijnen.
3. Gates-count in hydra-tutorial-4-skills — verholpen door naar 13 te gaan: 1 dispatcher (hydra-gates) + 13 individuele hydra-gate-* skills = 14 totaal, wat klopt met de gates-familie-tabel en met "Alle 14 draaien in de Hydra-fabriek". De container-tabel en de quiz-antwoord-block zijn beide gepatched.

Polish meegenomen

• 7-level framework — deel 1 kondigt het nu expliciet aan in de intro-zin: "in deel 3 introduceren we het 7-level maturity-framework … (deel 4 gaat door op L6 en L7)".
• Eerste persoon meervoud — narrative-prose hits ("we laden ze bij Juan en Clyde", "in onze eigen skill-toolchain", "onze create-pr-skill", "we gebruiken in Hydra", "we delen graag") teruggeschreven naar derde persoon / passief / "Conduction". ContactCta-blokken blijven "Stuur ons een mail" — dat is de bestaande Conduction-CTA-stijl.
• git-status-summary guardrail — toegevoegd: "Never pass --ignored to git status. The 'X is not blank and not ?' staged-check would otherwise also match ! (ignored) lines and produce a wrong staged group."
• Viervoudig-backtick block in deel 2 — geverifieerd met docusaurus build op Node 20: MDX-loader parse't 'm zonder warnings. Onze vier nieuwe pagina's en de hernoemde Hydra-deel-4 compileren cleanly. (De build hapert wel op deskdesk-tutorial-1-scaffold door een unrelated AtomZones-import — staat al op development in f11bed4c, los van deze PR.)

Klaar om te mergen vanuit deze kant; peer-review op Nederlandse stijl + de live /skill-creator-dialoog-check laat ik aan jou over.