git-changelog

A CHANGELOG generator that creates structured CHANGELOG.md files from git history.

Features

• Conventional Commits: Detects feat:, fix:, docs:, refactor:, etc.
• Smart Fallback: Groups non-conventional commits by keywords (add, fix, remove, etc.)
• Version Tags: Groups commits by git tags when present
• AI-Enhanced: Uses claude --print for intelligent classification when available
• Claude Code Skill: Works as an OpenClaw/Claude Code skill via SKILL.md

Usage

# From any git repository
bash changelog.sh

# Custom output file
bash changelog.sh MY_CHANGELOG.md

As a Claude Code Skill

The included SKILL.md registers this as a /changelog-gen skill in Claude Code.

Output Format

# Changelog

## v1.2.0 (2026-03-28)

### Features
- Add user authentication (`a1b2c3d`) — *Author Name*

### Bug Fixes
- Fix login redirect loop (`d4e5f6g`) — *Author Name*

How It Works

1. Tries AI-enhanced generation via claude --print (if available)
2. Falls back to rule-based classification:
   • Parses conventional commit prefixes
   • Matches keywords for non-conventional messages
   • Groups by version tags or "Unreleased"
3. Writes formatted Markdown to CHANGELOG.md

License

MIT