← Back to Skills Marketplace
Git Changelog Generator
by
charlie-morrison
· GitHub ↗
· v1.0.0
· MIT-0
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
- Collect — reads git log between specified ranges
- Parse — extracts conventional commit types (feat, fix, refactor, docs, test, chore, perf, ci)
- Categorize — groups changes by type with human-readable headers
- Enrich — adds PR links, issue references, author attribution, breaking change warnings
- Format — outputs in the requested format
Conventional Commit Support
Parses standard prefixes:
feat:→ Featuresfix:→ Bug Fixesrefactor:→ Code Refactoringdocs:→ Documentationtest:→ Testsperf:→ Performanceci:→ CI/CDchore:→ MaintenanceBREAKING 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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install git-changelog-generator - After installation, invoke the skill by name or use
/git-changelog-generator - 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
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