← Back to Skills Marketplace
charlie-morrison

Git Changelog Generator

by charlie-morrison · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
48
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install git-changelog-generator
Description
Generate structured changelogs from git history using conventional commits, with support for multiple formats, AI-enhanced descriptions, and customizable ran...
README (SKILL.md)

Git Changelog Generator

Generate structured changelogs from git history. Supports conventional commits, semantic versioning, and multiple output formats. Use when preparing releases, writing release notes, or documenting project history.

Usage

# Generate changelog for latest unreleased changes
python3 scripts/generate_changelog.py

# Generate changelog between two tags
python3 scripts/generate_changelog.py --from v1.2.0 --to v1.3.0

# Generate for last N commits
python3 scripts/generate_changelog.py --last 20

# Generate since a date
python3 scripts/generate_changelog.py --since 2026-04-01

Output Formats

# Markdown (default)
python3 scripts/generate_changelog.py --format markdown

# Keep a Changelog format (keepachangelog.com)
python3 scripts/generate_changelog.py --format keepachangelog

# GitHub Release format
python3 scripts/generate_changelog.py --format github-release

# JSON (for programmatic use)
python3 scripts/generate_changelog.py --format json

How It Works

  1. Collect — reads git log between specified ranges
  2. Parse — extracts conventional commit types (feat, fix, refactor, docs, test, chore, perf, ci)
  3. Categorize — groups changes by type with human-readable headers
  4. Enrich — adds PR links, issue references, author attribution, breaking change warnings
  5. Format — outputs in the requested format

Conventional Commit Support

Parses standard prefixes:

  • feat: → Features
  • fix: → Bug Fixes
  • refactor: → Code Refactoring
  • docs: → Documentation
  • test: → Tests
  • perf: → Performance
  • ci: → CI/CD
  • chore: → Maintenance
  • BREAKING CHANGE: → Breaking Changes (highlighted)

Non-conventional commits are categorized as "Other Changes" with AI-assisted categorization.

Parameters

Parameter Description Default
--from Start tag/commit Last tag
--to End tag/commit HEAD
--last Last N commits All since last tag
--since Start date (YYYY-MM-DD) None
--format Output format markdown
--output Write to file stdout
--repo Repository path Current directory
--include-authors Show commit authors false
--include-hashes Show commit hashes false
--group-by Group by type or scope type

AI Enhancement

When used as an agent skill, the AI can:

  • Rewrite terse commit messages into human-readable descriptions
  • Identify the most impactful changes and highlight them
  • Generate a summary paragraph for release announcements
  • Detect breaking changes even without conventional commit markers
  • Cross-reference with issue trackers for richer context
Usage Guidance
This skill is coherent and low-risk: it runs local git commands to build changelogs and requires no credentials. Before running, review the script if you want to be sure it will only read the intended repository path (default: current directory). If you expect the AI to enrich changelogs with issue data or external context, be aware that the skill does not include network code or credentials—any such lookups would come from the agent itself or other skills, so only allow those if you trust the agent's configured integrations.
Capability Analysis
Type: OpenClaw Skill Name: git-changelog-generator Version: 1.0.0 The skill bundle is a legitimate utility for generating changelogs from Git history. The Python script (scripts/generate_changelog.py) safely uses subprocess.run with argument lists to interact with the git CLI, avoiding shell injection vulnerabilities, and the SKILL.md documentation contains no malicious instructions or prompt injection attempts.
Capability Assessment
✓ Purpose & Capability
Name/description, SKILL.md usage examples, and the included Python script all align: the tool runs git log on a repository, parses conventional commits, groups and formats them. There are no unrelated environment variables, binaries, or install steps requested.
ℹ Instruction Scope
SKILL.md instructs running the bundled script and describes AI 'enhancements' (rewriting messages, cross-referencing issue trackers). The script itself performs only local git operations and formatting. The AI-enhancement language is high-level and gives the agent discretion to enrich output, but the skill does not include code or declared credentials to perform networked lookups; this is a mild vagueness rather than a mismatch.
✓ Install Mechanism
No install specification is provided (instruction-only + included script). Nothing is downloaded or written to disk by an installer; risk from install mechanisms is minimal.
✓ Credentials
The skill declares no required environment variables or credentials and the script does not read environment secrets. It only invokes git against a configurable repository path (default: current directory). No disproportionate credential access is requested.
✓ Persistence & Privilege
always is false and the skill does not modify agent/global configuration or other skills. It runs on demand and writes output only to stdout or a user-specified file.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install git-changelog-generator
  3. After installation, invoke the skill by name or use /git-changelog-generator
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Git Changelog Generator. - Generate structured changelogs from git history with support for conventional commits and semantic versioning. - Flexible output formats: Markdown, Keep a Changelog, GitHub Release, and JSON. - Supports various input options: by tag, date, or commit count. - Groups and enriches changes, highlighting features, fixes, breaking changes, and more. - Includes AI-powered enhancements for improved categorization and readable summaries.
Metadata
Slug git-changelog-generator
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Git Changelog Generator?

Generate structured changelogs from git history using conventional commits, with support for multiple formats, AI-enhanced descriptions, and customizable ran... It is an AI Agent Skill for Claude Code / OpenClaw, with 48 downloads so far.

How do I install Git Changelog Generator?

Run "/install git-changelog-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Git Changelog Generator free?

Yes, Git Changelog Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Git Changelog Generator support?

Git Changelog Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Git Changelog Generator?

It is built and maintained by charlie-morrison (@charlie-morrison); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments