changelog-generator · Changelog Generator
Changelog generator: turns git commit history into changelogs users actually understand — scanning commits across a time range or between versions, categorizing into features/improvements/fixes/breaking changes/security, translating technical language into user language, and filtering out internal noise (refactoring, tests).
Supports custom date ranges and custom style guides (e.g. CHANGELOG_STYLE.md) for consistent formatting. Review and adjust before publishing.
Example invocation: "Turn last week's commits into a changelog."
Full brief
Positioning
changelog-generator is a "translator" for git commits: turning technical commits into user-facing release notes. It generates changelogs, not releases.
Core capabilities
- History scanning: across a date range or version interval (e.g. since v2.4.0).
- Change categorization: features / improvements / fixes / breaking changes / security.
- Technical → user language: rewriting developer commits as customer-readable entries.
- Noise filtering: excluding refactoring, test, and other internal commits.
- Style consistency: custom style guides (e.g. CHANGELOG_STYLE.md) for format and brand voice.
Workflow
- Set scope (date range or version interval)
- Scan commit history
- Categorize (features/improvements/fixes/breaking/security)
- Translate to user language
- Format per style guide
- Review, adjust, then publish
Inputs & outputs
| Input | Notes |
|---|---|
| Time range or version interval | Required — e.g. "past 7 days," "since v2.4.0" |
| Git repository | Run from the project root |
| Style guide | Optional — CHANGELOG_STYLE.md etc. |
Output: structured changelog (features/improvements/fixes), ready for CHANGELOG.md.
Fit
- Release notes for new versions
- Weekly/monthly product update summaries
- App-store update descriptions
- Public changelog pages
Before you start
- Run from the git repository root.
- Review the generated changelog before publishing; adjust wording as needed.
changelog-generator is part of the Aiglade Skill library. Invoke it from the Aiglade chat box in plain language.