changelog-generator

Generate user-facing changelogs from git commit history with categorized release notes.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill changelog-generator-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-generator
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/changelog-generator
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill changelog-generator-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing changelogs manually means digging through git history, interpreting technical commits, and rewriting them in customer-friendly language, which consumes hours before every release. ## Core Features & Use Cases - Git History Analysis: Scans commits from a date range, version tag, or time period and filters out internal noise like refactoring and tests. - Automatic Categorization: Groups changes into features, improvements, bug fixes, breaking changes, and security updates. - Technical-to-User Translation: Converts developer commit messages into clear, customer-friendly release notes following your style guidelines. - Use Case: Before shipping version 2.5.0, run the skill against commits since v2.4.0 to produce a polished CHANGELOG.md section ready for GitHub releases, app store submissions, or customer update emails. ## Quick Start Create a changelog from all commits since the last release using my CHANGELOG_STYLE.md guidelines.

Frequently Asked Questions about changelog-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a changelog from git commits automatically?

Run the changelog generator from your repository root and specify a scope such as commits since the last release, a date range, or a version tag. It analyzes the commit history, categorizes changes, and outputs formatted Markdown release notes.

How to write release notes that users actually understand?

Translate technical commit messages into outcome-focused language describing what users gain, not what code changed. Group entries into features, improvements, and fixes, and filter out internal work like refactoring and test updates.

Can I generate a changelog for a specific date range or version?

Yes, you can scope generation to commits between two dates, since a specific version tag like v2.4.0, or a relative period such as the past week. Narrower ranges produce more focused changelogs.

Does the changelog generator follow custom formatting guidelines?

Yes, you can point it to a style file such as CHANGELOG_STYLE.md and it will apply your formatting conventions and brand voice to the generated entries. Review the output before publishing to confirm tone consistency.

What commits are excluded from generated changelogs?

Internal commits such as refactoring, test changes, and other developer-only noise are filtered out automatically. Only changes meaningful to end users appear in the final categorized output.