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.

ClaudeHermes AgentCodexCursorMIT (modify, redistribute and use commercially)Python

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

  1. Unzip the downloaded file (it contains a changelog-from-git/ folder with SKILL.md).
  2. 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
  3. Restart the agent and check that the skill appears in its skill list.

Step-by-step install for Windows / Mac and each agent

Seller

AI Skill Market (official)

44 published skills

Seller profile and all skills