Turn Git Commits into Professional Release Notes

Transforming a messy git history into a readable changelog shouldn't be a manual chore. This skill automates the extraction and categorization of commit data, providing polished Markdown release notes ready for GitHub, GitLab, or your CHANGELOG.md file.

What it does

The Changelog Generator scans your repository's history based on tags, commit ranges, or a specific count. It performs the following at a high level:

• Intelligent Parsing: Analyzes commit subjects and bodies for Conventional Commit types (feat, fix, docs, etc.).
• Breaking Change Detection: Automatically identifies breaking changes via ! markers or BREAKING CHANGE: footers.
• Automatic Categorization: Groups updates into emoji-labeled sections for maximum readability.
• SemVer Suggestions: Proposes the next version number (Major, Minor, or Patch) based on the nature of the changes detected.

Why use this skill?

While you could ask a basic AI to "summarize these commits," this skill follows a rigorous logic gate to ensure consistency. It handles edge cases like malformed commit messages, complex tag comparisons (e.g., v1.0.0..HEAD), and cross-referencing breaking changes across sections. It translates technical commit jargon into user-facing language, saving developers hours of manual editing.

Output Format

The result is a structured Markdown document including a summary of the commit range, categorized bullet points with short hashes, and a suggested version increment.