Wat is een 'skill' in de AI-context, en hoe bouw je er een voor je workflow?

Question

Accepted Answer

Een **skill** verpakt een herbruikbare, on-demand workflow voor een AI-agent: **instructies** voor een terugkerende taak (wanneer en hoe), plus **optionele scripts of resources** die de agent alleen laadt wanneer de taak relevant is. Het is het verschil tussen elke keer een procedure opnieuw uitleggen en het eenmaal onderwijzen.

## Wat een skill is

```text
SKILL = a self-contained folder the agent can pull in on demand:
  SKILL.md   → metadata + instructions (the TRIGGER + the STEPS)
  scripts/   → optional helper scripts the agent runs (e.g. a linter, a generator)
  resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
```

Het voordeel is **progressieve onthulling**: de agent weet dat de skill *bestaat* op basis van een korte beschrijving, en haalt de volledige instructies en scripts alleen op wanneer een overeenkomende taak verschijnt — zodat tientallen skills niet elk gesprek opblazen.

## Een skill bouwen

Een skill heeft drie onderdelen: de **trigger** (wanneer), de **stappen** (hoe), en alle **helper scripts** (tools). Houd het gericht en samenstelbaar — één taak goed gedaan, geen alles-wat-je-hebt.

```markdown
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry

## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
```

De `description` is de **trigger** — het vertelt de agent wanneer hij deze skill moet gebruiken. De genummerde lijst zijn de **stappen**, en `validate.sh` is een **helper script** dat correctheid afdwingt zodat de agent niet hoeft na te denken over opmaak. Omdat de skill klein en single-purpose is, combineert het netjes met andere (bijv. een aparte 'release' skill kan het aanroepen).

## Waarom het belangrijk is

Skills veranderen een agent van een algemene assistent die je voortdurend moet bijpraten in een agent die *jouw* terugkerende procedures kent. Door de trigger, stappen en scripts in een gericht, samenstelbaar unit in te pakken dat alleen on-demand laadt, codeer je institutionele kennis eenmaal en hergebruik je die betrouwbaar — consistente resultaten op repetitieve taken zonder ze opnieuw uit te leggen, en zonder de contextkosten van elke workflow op elk verzoek te betalen.