Changelog section from git history between tags
Groups the commits between two tags or refs into breaking changes, features, fixes and more, producing a CHANGELOG or release-notes section. Headings in English or Japanese.
What it does
Builds one CHANGELOG section from the git log between tags (or branches or commits).
- Parses Conventional Commits (
feat:,fix(auth):,feat!:and so on) and groups them under headings by type - Puts
BREAKING CHANGE:footers and!commits first under breaking changes - Uses the previous tag automatically when the start ref is omitted
- Adds compare, commit and issue links when given a GitHub or GitLab URL
- Drops a commit and its revert when both are in the range
- Hides style, chore, ci and test by default and reports their counts; non-conventional commits go under Other with a count
- Headings in English or Japanese (
--lang ja)
How to use
python scripts/changelog_from_git.py --from v1.3.0 --to v1.4.0 --url https://github.com/owner/repo
The agent rewrites the draft into reader-friendly wording and edits CHANGELOG.md only when asked.
Requirements
- Python 3 (standard library only)
- Git 2.25+
Caveats
- The script only reads history; it never creates tags, pushes, or edits files.
- In repositories that do not use Conventional Commits, most commits land under Other; the agent then classifies them from subjects and diffs.
- The date is the commit date of
--to, not the tag creation date.
How to install
- Unzip the downloaded file (it contains a
changelog-from-git/folder withSKILL.md). - Copy the whole folder into your agent's skills folder.
- Claude:
~/.claude/skills/(per project:.claude/skills/) - Hermes Agent:
~/.hermes/skills/ - Codex:
~/.agents/skills// Cursor:~/.cursor/skills/ - Claude app (claude.ai): upload the ZIP in Customize → Skills
- Claude:
- Restart the agent and check that the skill appears in its skill list.
Seller
AI Skill Market (official)
44 published skills