# Release Notes

> Draft a release note section from a commit range, grouped by what the reader gets.

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

---


# release-notes

## When to use
Asked to draft the changelog section for a version bump.

## Steps
1. Read the commit range and partition it -- account for every commit.
2. Group by what the reader gets, most interesting first. Never by commit type.
3. Lead with breaking changes when the release has any.

## Gotchas
- A list of commit subjects is not a changelog section.
- Never restate a count of commits.