
Changelog Generator
Transform git commits into polished, semantic changelogs with issue linking
What You Can Do
You can feed Claude your git commit messages, pull request descriptions, and version tags, and it will generate a polished CHANGELOG.md file organized by semantic version and change type (Added, Changed, Fixed, Removed, Deprecated, Security). The skill extracts meaningful information from unstructured commits, validates semantic versioning compliance, and creates traceable links to source PRs and issues—turning developer-focused git history into transparent, end-user-facing release documentation.
Features
Automatically sorts changes into Added, Changed, Fixed, Removed, Deprecated, and Security sections within each version
Generates markdown output following the Keep a Changelog standard for consistency and readability
Creates clickable references to GitHub/GitLab issues and pull requests from commit metadata
Verifies version numbers follow semver conventions (MAJOR.MINOR.PATCH) and flags inconsistencies
Parses raw commit messages and PR descriptions to extract meaningful change summaries
Arranges releases chronologically (newest first) with clear section headers and formatting
Identifies and highlights deprecations and breaking changes for user awareness
Adapts human-readable summaries for different audiences (technical vs. non-technical)
Example Output
Input: Git commits and PR data for version 2.1.0 release
commit: feat: add dark mode support (#234)
commit: fix: resolve memory leak in cache handler (#198)
commit: docs: update API reference
commit: BREAKING CHANGE: remove deprecated API endpoint
Output: CHANGELOG.md excerpt
## [2.1.0] - 2024-01-15
### Added
- Dark mode support with automatic theme detection ([#234](https://github.com/org/repo/pull/234))
### Fixed
- Memory leak in cache handler during long-running operations ([#198](https://github.com/org/repo/pull/198))
### Removed
- Deprecated REST API v1 endpoint (use GraphQL API instead)
### Security
- Patched XSS vulnerability in markdown renderer
What's Included
- SKILL.md instruction file with changelog generation logic and Keep a Changelog reference:
- CHANGELOG.md template: Pre-formatted markdown structure ready for your releases
- Git commit parsing guide: Best practices for structuring commits to maximize changelog quality
- Version validation checklist: Rules for semantic versioning and what to look for in release cycles
- Issue linking reference: GitHub/GitLab syntax examples for automatic PR and issue references
Who It's For
- Open-source maintainers — Managing multiple releases and communicating changes to community users
- Technical writers — Creating release notes and documentation from developer input
- Engineering leads — Preparing polished release documentation without manual transcription
- Product managers — Translating commits into user-facing release highlights
- DevOps engineers — Automating changelog generation as part of CI/CD release workflows
Best For
- Generating release notes from 5+ commits between tagged versions
- Converting unstructured git history into semantic, categorized changelog entries
- Creating traceable links between user-facing release notes and source code changes
- Ensuring release documentation follows Keep a Changelog or similar standards
- Identifying and highlighting breaking changes and security fixes for stakeholders







