Skip to content

Changelog Generator

Caution

Release notes agent that reads git history, groups commits by type, and produces formatted changelogs following Keep a Changelog conventions.

By Anthropic 3,800 v1.1.0 Updated 2026-03-10

Install

Claude Code

Copy the SKILL.md file to your project's .claude/skills/ directory

About This Skill

Changelog Generator reads your git history between two tags or dates and produces well-organized release notes. It understands conventional commit messages, groups changes by type (features, fixes, breaking changes), and writes human-readable summaries that go beyond raw commit messages.

How It Works

  1. Range detection — Identifies the commit range from the last tag or specified date to HEAD, or between two specified versions
  2. Commit parsing — Reads commit messages and identifies conventional commit prefixes (feat:, fix:, chore:, BREAKING CHANGE:)
  3. Grouping — Organizes commits into Added, Changed, Fixed, Removed, and Breaking Changes sections
  4. Summarization — Rewrites terse commit messages into user-friendly descriptions that explain the impact of each change
  5. Formatting — Outputs in Keep a Changelog format with version number, date, and linked comparison URLs

Best For

  • Teams using conventional commits who want automated release notes
  • Open source maintainers keeping CHANGELOG.md up to date
  • Product managers who need user-facing release summaries
  • CI/CD pipelines that generate release notes on tag creation

Use Cases

  • Release notes for versioned software releases
  • Sprint retrospective change summaries
  • Open source project changelog maintenance
  • Customer-facing update announcements

Pros & Cons

Pros

  • + Understands conventional commit format automatically
  • + Produces human-readable summaries beyond raw commit messages
  • + Follows Keep a Changelog standard format
  • + Detects breaking changes and highlights them prominently

Cons

  • - Quality depends on commit message quality — garbage in, garbage out
  • - May misclassify commits with non-standard or missing prefixes

Related AI Tools

Related Skills

Stay Updated on Agent Skills

Get weekly curated skills + safety alerts

每周精选 Skills + 安全预警