releasenotes
Generate formatted changelogs from git history since the last release tag. Use when preparing release notes that categorize changes into breaking changes, features, fixes, and other sections.
When & Why to Use This Skill
This Claude skill automates the generation of professional, structured changelogs by analyzing Git history and pull requests since the last release. It streamlines the software release cycle by intelligently categorizing commits into breaking changes, features, and fixes, ensuring high-quality documentation for GitHub releases with minimal manual effort.
Use Cases
- Automated Release Notes: Generate ready-to-publish markdown changelogs for GitHub or GitLab releases by comparing the current branch against the most recent version tag.
- Development Progress Tracking: Summarize all merged pull requests and key features implemented during a sprint to provide stakeholders with a clear overview of technical progress.
- Contributor Attribution: Automatically identify and credit developers for their specific contributions and bug fixes in the final release documentation.
- Breaking Change Auditing: Scan commit history to ensure all breaking changes are highlighted and documented properly before a major version deployment.
| name | releasenotes |
|---|---|
| description | Generate formatted changelogs from git history since the last release tag. Use when preparing release notes that categorize changes into breaking changes, features, fixes, and other sections. |
Generate a changelog for all changes from the most recent release until now.
Steps
- Find the most recent release tag using
git tag --sort=-creatordate - Get commits and merged PRs since that tag
- Look at previous releases in this repo to match their format and style
- Categorize changes into sections: Breaking Changes, Added, Changed, Fixed, Notes
- Focus on user-facing changes (features, important bug fixes, breaking changes)
- Include PR links and contributor attribution
Output
Present the changelog in a markdown code block, ready to copy-paste into a GitHub release.