| name | release-notes |
| description | Produces release notes and changelog entries from commits, pull requests, or diffs with clear user impact and upgrade guidance. |
Release Notes
Use this skill when drafting release notes, changelog entries, upgrade notes, or release summaries.
Inputs
- Commit log, pull request list, diff, issue list, or milestone notes
- Target audience: users, developers, operators, or internal stakeholders
- Version number, release date, and compatibility constraints if known
Steps
- Group changes by user impact: Added, Changed, Fixed, Security, Deprecated, Removed, Performance, Documentation.
- Translate implementation details into outcomes without hiding important technical changes.
- Identify breaking changes, migration steps, config changes, and operational actions.
- Call out security fixes without exposing exploit details.
- Remove duplicates and merge related items.
- Keep known issues and follow-up work separate from shipped changes.
Output
Return:
- Release summary
- Categorized changelog
- Upgrade or migration notes
- Known issues
- Verification or rollout notes when useful
Guidelines
- Be accurate about what shipped.
- Avoid vague phrases like "various improvements."
- Preserve version and date details exactly when provided.
