← Back to Skills Marketplace
274
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install jrv-changelog-gen
Description
Generate changelogs from git commit history with conventional commit parsing. Use when asked to generate a changelog, create release notes, summarize git his...
README (SKILL.md)
Changelog Generator
Generate clean, professional changelogs from git commit history.
Quick Start
python3 scripts/changelog_gen.py
python3 scripts/changelog_gen.py --since v1.0.0 --group
python3 scripts/changelog_gen.py --since v1.0.0 --until v2.0.0 --format json
python3 scripts/changelog_gen.py --repo /path/to/project --since "2026-01-01" -o CHANGELOG.md
Features
- Conventional commit parsing — auto-detects feat, fix, docs, refactor, perf, test, build, ci, chore, revert
- Breaking change detection — from
!suffix orBREAKING CHANGEin body - Grouped output — organize by commit type with
--group - Tag ranges — generate changelogs between any two tags or refs
- Dual format — markdown (default) or JSON
- File output — write directly to CHANGELOG.md with
-o - No dependencies — Python stdlib + git
Options
| Flag | Description |
|---|---|
--repo PATH |
Path to git repo (default: cwd) |
--since REF |
Start ref — tag, branch, or commit |
--until REF |
End ref (default: HEAD) |
--format md|json |
Output format (default: md) |
--group |
Group commits by type |
-o FILE |
Write to file |
Conventional Commit Types
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert — all parsed automatically.
Usage Guidance
This skill appears to do what it claims: it runs git locally to build changelogs and can write the result to a file. Before using it: ensure the machine has git and Python installed (the metadata should have declared git but did not), verify you point it to the intended repository path, and review commit messages if they contain sensitive information (commit history may include secrets). Because it executes git in the repo, run it in a trusted environment and confirm the script is acceptable to you before granting an agent autonomous permission to invoke it.
Capability Analysis
Type: OpenClaw Skill
Name: jrv-changelog-gen
Version: 1.0.0
The skill is a standard utility for generating changelogs from git history using conventional commit parsing. The Python script (scripts/changelog_gen.py) uses the subprocess module safely to execute git commands without shell invocation, and it contains no network calls, data exfiltration logic, or obfuscated code. The instructions in SKILL.md are strictly aligned with the tool's stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the included script: the tool parses conventional commits from a local git repo and formats markdown/JSON changelogs. One minor inconsistency: the skill metadata lists no required binaries, but the script invokes the system 'git' command — git is a legitimate and necessary dependency for this purpose and should be declared.
Instruction Scope
SKILL.md and the script instruct the agent to run the included Python script against a specified repo. The script only runs git commands (git log, rev-parse) against the repo and writes output to stdout or a user-specified file. It does not read arbitrary unrelated system files, access environment variables, or transmit data externally.
Install Mechanism
This is an instruction-only skill with a bundled script; there is no install spec, no downloads, and nothing is written to disk by an installer. The runtime requires Python and the git binary, but no install mechanism is provided (which is acceptable for an instruction-only skill).
Credentials
The skill requests no environment variables or credentials. It does require access to a local git repository and the git CLI; those are proportionate to its stated function. The omission of 'git' from declared required binaries is the only discrepancy.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent privileges. It can write an output file only when the user supplies a path (or runs it in a writable directory), which is expected behavior for a changelog generator.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jrv-changelog-gen - After installation, invoke the skill by name or use
/jrv-changelog-gen - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: conventional commit parsing, grouped output, breaking change detection, markdown and JSON format
Metadata
Frequently Asked Questions
What is Changelog Generator?
Generate changelogs from git commit history with conventional commit parsing. Use when asked to generate a changelog, create release notes, summarize git his... It is an AI Agent Skill for Claude Code / OpenClaw, with 274 downloads so far.
How do I install Changelog Generator?
Run "/install jrv-changelog-gen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Changelog Generator free?
Yes, Changelog Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Changelog Generator support?
Changelog Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Changelog Generator?
It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.
More Skills