changelog-gen – OpenClaw Skill

---

name: changelog-gen description: Generate changelogs from git history. Use when you need release notes fast.

Changelog Generator

Writing changelogs by hand is tedious. This tool reads your git history between two refs and generates a properly categorized changelog entry. No more copy-pasting commit messages.

One command. Zero config. Just works.

Quick Start

npx ai-changelog --from v1.0.0 --to v2.0.0

What It Does

• Reads git log between any two refs (tags, branches, commits)
• Groups commits into Added, Changed, Fixed, Removed
• Cleans up messy commit messages into readable entries
• Outputs markdown ready for your CHANGELOG.md

Usage Examples

# Between two tags
npx ai-changelog --from v1.0.0 --to v2.0.0

# From a tag to HEAD
npx ai-changelog --from v1.0.0 --to HEAD

# Write directly to file
npx ai-changelog --from v1.0.0 --to v2.0.0 -o CHANGELOG.md

# Specific commit range
npx ai-changelog --from abc123 --to def456

Best Practices

• Tag your releases - makes generating changelogs way easier
• Write decent commits - garbage in, garbage out
• Review the output - AI might miscategorize some changes
• Run before release - make it part of your release checklist

When to Use This

• Preparing a release and need changelog entries
• You forgot to maintain the changelog and need to catch up
• Want consistent changelog formatting across releases
• Generating release notes for GitHub releases

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

• GitHub: https://github.com/LXGIC-Studios
• Twitter: https://x.com/lxgicstudios
• Substack: https://lxgicstudios.substack.com
• Website: https://lxgicstudios.com

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

npx ai-changelog --help

How It Works

Runs git log between your specified refs, collects all commit messages, and sends them to GPT-4o-mini. The AI parses the commits, understands what each change does, and formats them into proper Keep a Changelog style with appropriate categories.

License

MIT. Free forever. Use it however you want.

ai-changelog

AI-powered changelog generator from git history. Creates clean, categorized release notes.

Generates a clean, categorized changelog from your git history. You give it two refs (tags, branches, commits) and it reads the log between them, then uses OpenAI to turn that mess of commit messages into a proper CHANGELOG entry.

Install

npm install -g ai-changelog

Setup

You'll need an OpenAI API key:

export OPENAI_API_KEY=sk-your-key-here

Usage

# Between two tags
npx ai-changelog --from v1.0.0 --to v2.0.0

# From a tag to HEAD
npx ai-changelog --from v1.0.0 --to HEAD

# Write directly to a file
npx ai-changelog --from v1.0.0 --to v2.0.0 -o CHANGELOG.md

It'll group your commits into Added, Changed, Fixed, Removed. No more hand-writing changelogs.

What it does

1. Reads git log between the two refs you give it
2. Sends the commit list to OpenAI
3. Gets back a nicely formatted changelog entry
4. Prints it or writes it to a file

That's it. Nothing fancy, just saves you 20 minutes every release.