| name | release-notes-synthesizer |
| description | create release notes from commit history. Trigger when preparing a release, summarizing changes, or writing a changelog. Understands Conventional Commits. |
Release Notes Synthesizer
Generate professional release notes based on the project's commit history.
Workflow
-
Gather History
- List commits since the last tag.
- Filter out irrelevant commits (e.g., "wip", "merge").
-
Categorize Changes
- Features (
feat): New user-facing capabilities.
- Fixes (
fix): Bug resolutions.
- Refactors (
refactor): Internal improvements.
- Chores (
chore): Maintenance/Chores.
- Breaking Changes (
! or BREAKING CHANGE): Critical warnings.
-
Draft the Notes
- Headline: Major version or theme of the release.
- Sections: Features, Fixes, Chores.
- Highlight: Call out the most impactful change first.
-
Format
Use Markdown list items. Keep descriptions concise.
Example
Input: "Draft notes for the last 5 commits."
Commits:
feat(audio): add reverb effectfix(ui): correct button alignmentchore: update deps
Output:
# Release v1.2.0
## Features
- **Audio**: Added new reverb effect to the synth engine.
## Bug Fixes
- **UI**: Fixed button alignment issues in the main menu.
## Maintenance
- Updated dependencies to latest stable versions.
Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.
