An automated versioning tool that analyzes commit history to determine semantic version bumps and generate git tags.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install release-gen
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install release-gen using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Release Gen?
Release Gen is a specialized utility designed to eliminate the manual overhead of version management. By analyzing git commit history since the previous tag, it intelligently determines the appropriate semantic version bump—major, minor, or patch—ensuring consistency across your development lifecycle. This tool is a powerful component of the Openclaw Skills ecosystem, offering a zero config approach to maintaining project history and release cycles.
Whether you use conventional commits or standard messaging, Release Gen interprets the impact of your changes to suggest version updates and generate comprehensive changelogs. It empowers developers to focus on writing code while automating the tedious task of release preparation.
Release Gen Use Cases
- Automatically determining the next semantic version number based on recent changes.
- Generating professional, categorized changelogs for project documentation.
- Standardizing git tagging processes across collaborative development teams.
- Streamlining the release pipeline for CI/CD environments.
- Previewing version impacts with dry-run modes before making permanent repository changes.
How Release Gen Works
- The tool identifies the most recent git tag or starts from the initial commit if no tags exist.
- It extracts and analyzes the git log history between the last tag and the current HEAD.
- Using AI logic, it classifies commits based on their impact: breaking changes trigger a major bump, new features trigger a minor bump, and bug fixes trigger a patch.
- Upon confirmation, it creates an annotated git tag and updates the project changelog file.
Release Gen Setup
Release Gen requires Node.js 18 or higher and an OpenAI API key. No permanent installation is necessary as it can be executed via npx.
# Set your API key
export OPENAI_API_KEY=sk-...
# Run the tool to analyze and suggest a version bump
npx ai-release
Release Gen Data Schema & Taxonomy
Release Gen interacts with your local git repository and generates structured text outputs.
| Element | Description |
|---|---|
| Git Tag | An annotated tag follows the vX.Y.Z format. |
| Changelog | A Markdown file (usually CHANGELOG.md) updated with categorized commit notes. |
| Version Logic | Uses Semantic Versioning 2.0.0 (Major.Minor.Patch). |
| Metadata | Derived from Git author, date, and commit message content. |
Release Gen Advanced Features
- Dry-run capability to simulate version bumps without modifying the repository.
- Manual bump overrides using the --bump flag for major, minor, or patch increments.
- Support for pre-release tagging (e.g., beta, alpha) via the --prerelease option.
- Compatibility with conventional commit standards for enhanced analysis accuracy.
- Integration-ready CLI for use within broader Openclaw Skills automation scripts.
SKILL.md
Loading
Related Openclaw Skills
Regex Writer
A powerful utility that converts plain English descriptions into functional, tested regular expression patterns.
Regex Gen
An AI-powered CLI tool that translates natural language descriptions into precise, validated regular expression patterns.
Refactor Assistant
A CLI-based refactoring tool that analyzes code for quality improvements and displays actionable colored diffs.
Refactor Assistant
Get instant, AI-driven refactoring suggestions with colored diffs to improve code quality and maintainability.
Release Notes Generator
An automated tool that converts complex git commit logs into polished, category-grouped release notes for users.
Responsive Maker
Transform desktop-only components into fully responsive, mobile-optimized UI elements instantly.
Featured*
