# Changelog Generator

> Genereer gebruiksvriendelijke changelogs uit git commits. Analyseert commit-historie, categoriseert wijzigingen, en vertaalt technische commits naar heldere release notes.

- Skill: `nationaalduurzaambeheer/changelog-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nationaalduurzaambeheer/changelog-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nationaalduurzaambeheer/changelog-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Nationaalduurzaambeheer (https://skillmd.com/u/nationaalduurzaambeheer)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/nationaalduurzaambeheer/changelog-generator

---


# Changelog Generator

Transformeer technische git commits in gepolijste, gebruiksvriendelijke changelogs.

## Wanneer Gebruiken

- Release notes voorbereiden voor een nieuwe versie
- Wekelijkse of maandelijkse product-updates samenvatten
- Changelog voor app store submissions
- Interne release documentatie

## Instructies

### Stap 1: Commits Ophalen

```bash
# Sinds laatste tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

# Laatste 7 dagen
git log --since="7 days ago" --oneline --no-merges

# Tussen twee versies
git log v2.4.0..v2.5.0 --oneline --no-merges
```

### Stap 2: Categoriseren

Groepeer commits in deze categorieën:

- **✨ Nieuwe Features** — Nieuwe functionaliteit voor de gebruiker
- **🔧 Verbeteringen** — Bestaande features die beter werken
- **🐛 Bug Fixes** — Opgeloste problemen
- **⚠️ Breaking Changes** — Wijzigingen die actie vereisen
- **🔒 Security** — Beveiligingsupdates

### Stap 3: Vertalen

Regels voor vertaling van technisch → gebruikersvriendelijk:

1. **Geen technisch jargon** — "Fixed null pointer in auth middleware" → "Inlogproblemen opgelost"
2. **Gebruiker-perspectief** — Wat verandert er voor hen?
3. **Actieve taal** — "Je kunt nu..." in plaats van "Er is een optie toegevoegd voor..."
4. **Filter ruis** — Skip: refactoring, tests, CI/CD, dependency bumps, formatting

### Stap 4: Formatteren

```markdown
# Release Notes — v2.5.0 (31 maart 2026)

## ✨ Nieuw

- **Team Workspaces**: Maak aparte werkruimtes per project.
  Nodig teamleden uit en houd alles georganiseerd.

- **Sneltoetsen**: Druk op ? voor alle beschikbare shortcuts.

## 🔧 Verbeterd

- **Snellere sync**: Bestanden synchroniseren nu 2x sneller
- **Beter zoeken**: Zoekt nu ook in bestandsinhoud

## 🐛 Opgelost

- Grote afbeeldingen konden niet worden geüpload
- Tijdzone-verwarring in geplande berichten

## ⚠️ Let Op

- Minimale Node.js versie is nu 18 (was 16)
```

## Opties

- `--format markdown` — Standaard, voor CHANGELOG.md
- `--format slack` — Compacte bullet list voor Slack/Discord
- `--format email` — HTML-formatted voor e-mail nieuwsbrief
- `--lang nl` — Nederlands (standaard)
- `--lang en` — Engels

## Tips

- Draai vanuit de root van je git repository
- Gebruik `CHANGELOG_STYLE.md` in je repo voor consistente opmaak
- Review altijd voor publicatie — AI mist soms context
- Sla op naar `CHANGELOG.md` en commit mee met de release