| name | release-notes |
| display_name | Release Notes |
| description | Produces release notes and changelog entries from commits, pull requests, or diffs with clear user impact and upgrade guidance. |
| category | git-workflow |
| version | 1.0.0 |
| tags | ["release-notes","changelog","git","communication","versioning"] |
| providers | ["claude-code","codex","copilot","openclaw","hermes-agent"] |
| author | agent-skills contributors |
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.
