What problem does it solve?
Manually compiling release notes from scattered git commits, pull request metadata, and change logs is time-consuming, inconsistent, and often misses critical operational details like breaking changes, database migrations, or new environment variables that are essential for safe deployments.
Core Features & Use Cases
- Auto-range detection: Automatically identifies the correct commit range to document (since the last git tag, last deploy marker, or merge-base with the default branch) so you don't have to manually specify SHAs.
- PR-enriched classification: Pulls titles, labels, and bodies from merged GitHub PRs (via GitHub MCP or the gh CLI) to classify changes accurately by user impact, rather than relying solely on terse commit messages.
- Multi-format output: Generates notes in markdown, compact deploy comments, Keep a Changelog entries, or GitHub release bodies to fit every step of your release workflow.
- Operational risk surfacing: Prominently flags breaking changes, data migrations, and new required environment variables, and recommends an appropriate SemVer bump with clear justification.
- Use case: For a team shipping a new payment processing feature, this skill automatically pulls all related commits and PRs, groups them into user-facing notes, flags the required database migration for transaction records, and recommends a minor version bump for the release.
Quick Start
Use the release-notes skill to generate human-facing release notes for all changes since the last git tag, formatted as a markdown document ready for your changelog.
