An automated AI agent skill that analyzes Git histories, extracts merged pull requests, and generates strict Keep a Changelog compliant documentation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gen-release-notes
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 gen-release-notes 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 Notes Generator?
The Release Notes Generator is designed to automate the painful process of changelog curation. By analyzing the differential commits and tags within your Git history, this asset translates raw source repository activity into high-quality changelogs without inventing data. It ensures strict adherence to the Semantic Versioning criteria, providing predictable version bumps based entirely on repository evolution.
This workflow is optimized for automated ecosystems. By utilizing Openclaw Skills, developers can bypass manual review cycles, eliminate human formatting errors, and enforce strict verification gates to guarantee footer link correctness across complex codebases.
Release Notes Generator Use Cases
- Automating changelog generation inside continuous integration pipelines prior to tag production.
- Auditing repository history since a specified Git tag to evaluate version impact (Major, Minor, or Patch).
- Standardization of team releases using structured Conventional Commits parsing and automated pull request linking.
How Release Notes Generator Works
- Gather Changes: The system verifies the existence of the previous tag, lists internal commits since that tag while ignoring merge commits, and pulls valid GitHub PR records using the official CLI.
- Analyze and Categorize: Commits are filtered and sorted strictly into predefined buckets: Added, Changed, Deprecated, Removed, Fixed, and Security.
- Determine Version Number: Evaluates API alterations and breaking changes to propose the next Semantic Versioning step.
- Write Release Notes: Constructs the markdown blocks featuring imperative verbs, bold scoped structures, and precise migration pathways.
- Update CHANGELOG.md: Injects raw markdown changes and automatically calculates historical footer comparison URLs.
- Verify Links (HARD GATE): Validates the staged changelog index files using exact pattern verification scripts to prevent broken footer endpoints before final push routines.
Release Notes Generator Setup
Ensure you have your environment configured with git and the GitHub CLI (gh). Invoke the automation flow directly by providing your historical reference target.
# Invoke the automation workflow targeting a specific base tag
openclaw run gen-release-notes "v1.2.0"
Release Notes Generator Data Schema & Taxonomy
The skill manages information extracted directly from git object references and standard changelog files.
| Data Object | Format | Purpose |
|---|---|---|
CHANGELOG.md |
Markdown File | Tracks chronological, user-facing history of changes following the Keep a Changelog spec. |
$STAGED_CHANGELOG |
Staged Memory Blob | Holds the indexed version of the changelog to execute validation constraints prior to physical commits. |
Footer Reference Links |
Comparative URLs | Tracks automated diff comparisons across project branches (.../compare/v1.0.0...v1.1.0). |
Release Notes Generator Advanced Features
- Hard enforcement compilation gates that prevent corrupted or un-advanced
[Unreleased]references from breaking upstream deployment sequences. - Automated extraction and mapping of explicit structural prefixes using standard Conventional Commits methodology.
- Robust isolation mechanisms that actively exclude internal CI/CD, style refactors, and test files from user-facing documentation assets.
SKILL.md
Loading
Related Openclaw Skills
Review Plan
An automated AI agent skill that executes a rigorous, five-lens implementation plan review before executing code modifications.
Prompt Improver
An AI-agent tool designed to automatically audit and transform vague engineering prompts into clear, highly optimized instructions for code implementation, debugging, refactoring, and testing.
Remix v2 Data Flow Review
An advanced automated code review skill for analyzing and optimizing Remix v2 loader, action, and revalidation data flows.
respond-pr-feedback
An automated AI agent skill that posts contextual replies to GitHub Pull Request review comments and handles conversation thread resolution.
Receive Feedback
A highly disciplined Openclaw Skills extension to automatically verify, organize, and execute fixes for code review feedback.
opc-technical-due-diligence
A specialized technical due diligence screening tool designed for pre-investment feasibility analysis, background verification, and patent validation.
Featured*
