| name | create-skill |
| description | Scaffold een nieuwe CEDA Claude skill via een begeleide workflow. Gebruik wanneer iemand een nieuwe /skill wil aanmaken voor de cedanl organisatie, een bestaand proces wil codificeren als skill, of vraagt hoe je een skill bouwt. |
Create Skill
Begeleid de gebruiker stap voor stap bij het bouwen van een nieuwe Claude skill voor de cedanl organisatie. De skill zorgt dat het resultaat aansluit bij de CEDA-conventies en daadwerkelijk triggert wanneer dat hoort.
Workflow
When the user invokes /create-skill [optional: beschrijving]:
1. Prior art check
Lees de bestaande skills om dubbel werk te voorkomen en referenties te hebben:
ls .claude/skills/
Lees ook de SKILL.md van de meest vergelijkbare skill (op basis van de beschrijving van de gebruiker) als referentie voor structuur en tone-of-voice.
Rapporteer kort wat er al bestaat en of er overlap is. Als een bestaande skill uitgebreid kan worden in plaats van een nieuwe te bouwen, stel dat voor aan de gebruiker en stop hier.
2. Interview
Stel de vragen één voor één — wacht na elke vraag op het antwoord van de gebruiker voor je de volgende stelt.
Vraag 1 — Naam:
Hoe heet de skill? Gebruik kebab-case (bijv. check-stijl of maak-rapport).
Wacht op antwoord.
Vraag 2 — Doel:
Wat doet de skill in één zin? Wat is de concrete output die de gebruiker krijgt?
Wacht op antwoord.
Vraag 3 — Trigger:
Wanneer moet Claude deze skill automatisch activeren? Geef 2-3 voorbeeldberichten die een gebruiker zou sturen om deze skill te triggeren.
Wacht op antwoord.
Vraag 4 — Input:
Wat geeft de gebruiker mee bij het aanroepen? (bijv. een bestandspad, een naam, niets)
Wacht op antwoord.
Vraag 5 — Type output:
Is de output objectief (een bestand, een commit, een issue) of subjectief (een review, een advies)?
Wacht op antwoord voor je verder gaat naar stap 3.
3. Classificeer de skill
Op basis van de antwoorden: bepaal het type skill.
| Type | Kenmerken | Aanpak |
|---|
| Actie | Maakt iets aan of wijzigt iets (bestand, PR, issue, commit) | Workflow met bash-commando's + bevestigingsstap |
| Review | Beoordeelt iets (code, stijl, structuur) | Workflow met criteria-tabellen + bevindingen-format |
| Generatie | Produceert tekst of inhoud (notities, slides, docs) | Workflow met templates + draft → bevestig → publiceer |
| Wizard | Begeleidt door een proces via vragen | Workflow met interview → classificatie → uitvoer |
| Kennis | Legt conventies/feiten vast die Claude's aanpak sturen; geen procedure om uit te voeren | ## When this applies i.p.v. ## Workflow (zie hieronder) |
Noteer intern: welk type is dit? Dit bepaalt de structuur van de gegenereerde SKILL.md.
Actie/Review/Generatie/Wizard zijn workflow-skills — je roept ze aan om een
procedure uit te voeren. Kennis is anders: het is reference/convention die
Claude meestal impliciet laadt (op basis van de description) wanneer je in
dat gebied werkt — bijv. een SDP/Helm-error plakken, of een Dockerfile bewerken.
Er is geen procedure om te "runnen"; de waarde is dat Claude's volgende actie
juist is. Forceer bij zo'n skill geen ## Workflow.
4. Draft de SKILL.md
Genereer een volledige SKILL.md op basis van de antwoorden en het type. Gebruik onderstaande conventies:
Frontmatter
---
name: <kebab-case naam>
description: <één zin — begin met een werkwoord, sluit af met wanneer de skill actief is>
---
De description is het trigger-signaal waarmee Claude beslist of de skill relevant is. Schrijf hem zo dat hij matcht op de triggerberichten die de gebruiker opgaf.
Structuur
# <Naam in plain language>
<2-3 zinnen: wat doet de skill, voor wie, en wat is de concrete output.>
## Workflow
When the user invokes `/<naam> [optional: ...]`:
### 1. <Eerste stap>
...
### 2. <Volgende stap>
...
## Important
- <Kritieke randvoorwaarden>
- <Wat de skill expliciet NIET doet>
Structuur — kennis-skill
Voor een Kennis-skill is er geen procedure. Vervang ## Workflow door
## When this applies (wanneer/waarom Claude deze kennis laadt) en houd de rest
van de body als reference (conventies, tabellen, troubleshooting). ## Important
blijft verplicht.
# <Naam in plain language>
<2-3 zinnen: welke conventies/feiten legt deze skill vast, en waarom.>
## When this applies
This is a **knowledge skill** — it loads (explicitly via `/<naam>`, or
automatically) when <situatie waarin de kennis relevant is>. It is
reference/convention, not a step-by-step procedure.
## <Inhoudelijke secties>
<conventies, feiten, troubleshooting — de eigenlijke kennis>
## Important
- <Kritieke randvoorwaarden>
- <Wat de skill expliciet NIET doet>
Conventies
| Element | Conventie |
|---|
| Taal van de skill body | Engels (instructies aan Claude) |
| Taal van user-facing tekst | Nederlands (wat de gebruiker ziet) |
| Bash-commando's | Altijd in een code block |
| Bevestiging bij destructieve acties | Verplicht — toon draft, vraag akkoord |
| Tabellen | Gebruik voor keuzes, classificaties, formats |
| Bevindingen-format | Gebruik kopjes per categorie + ernst-indeling |
| Verwijzingen naar andere skills | Gebruik /skill-naam syntax |
Actie-skills: bevestigingsstap
Sluit elke actie-skill af met een expliciete bevestiging:
### N. Bevestig en voer uit
Toon een samenvatting van wat er aangemaakt/gewijzigd wordt:
> **Klaar om uit te voeren:**
> - [wat er gaat gebeuren]
>
> Doorgaan?
Wacht op akkoord van de gebruiker voor je schrijft, commit of publiceert.
5. Optimaliseer de description
De description in de frontmatter bepaalt of Claude de skill triggert. Controleer:
- Begint met een werkwoord (
Scaffold, Draft, Check, Genereer)
- Noemt het domein of de context (
CEDA, cedanl, Npuls)
- Sluit af met de trigger-conditie (
Gebruik wanneer...)
- Is maximaal twee zinnen
Vergelijk de description met de triggerberichten die de gebruiker opgaf in stap 2. Als de match zwak is, pas de description aan.
6. Toon de draft en wacht op akkoord
Presenteer de volledige gegenereerde SKILL.md aan de gebruiker:
Draft SKILL.md voor /<naam>
<volledige inhoud>
Klopt dit? Zeg wat je wil aanpassen, of geef akkoord om te schrijven.
Verwerk feedback en herhaal dit totdat de gebruiker akkoord geeft.
7. Schrijf de skill
Zodra de gebruiker akkoord geeft:
mkdir -p .claude/skills/<naam>
Schrijf de definitieve SKILL.md naar .claude/skills/<naam>/SKILL.md.
Rapporteer:
Skill aangemaakt: .claude/skills/<naam>/SKILL.md
Volgende stappen:
- Test de skill met
/create-skill → kijk of Claude hem triggert op jouw voorbeeldberichten
- Commit en push naar
cedanl/.github zodat de skill organisatiebreed beschikbaar is
- Gebruik
/write-issue om een PR aan te maken als je dat nog niet gedaan hebt
Important
- Schrijf altijd naar
.claude/skills/<naam>/SKILL.md in de cedanl/.github repo — niet in een project-repo
- Genereer nooit een skill die automatisch deployt, publiceert of force-pusht zonder expliciete bevestiging
- Als de gebruiker een bestaand proces wil vastleggen ("ik doe altijd X als Y"), behandel dat als een Actie- of Wizard-skill — vraag door naar de concrete stappen
- Refereer naar bestaande CEDA skills als voorbeeld, niet naar externe voorbeelden
- De skill ondersteunt alleen cedanl-repos — voeg dit toe aan de
## Important sectie van de gegenereerde skill indien relevant
