- Home
- Skills
- Technical Documentation
- generate-changelog
Generate Changelog
Generate a structured CHANGELOG.md from git history — a Claude Code skill + a dependency-free bash script.
Free
Works with the AI Agents you already use
generate-changelog
Example session with this skill installed
Generate a changelog for version 1.2.0 based on the commits since the last tag.
- Read your context and instructions
- Compiled the generate-changelog
I have parsed the git history and updated the CHANGELOG.md file for version 1.2.0.
1.2.0 - 2023-10-27
Added
- auth: support for OpenID Connect providers
- ui: dark mode toggle in user settings
Changed
- core: internal event bus now uses a singleton pattern
- refactored database connection pooling for better throughput
Fixed
- api: resolved race condition during concurrent write operations
- corrected broken link in documentation footer
Security
- updated dependency
joseto v4.15.4 to address CVE-2023-45133
Next steps
- Review the generated entries in
CHANGELOG.md. - Commit the changes to the repository.
- Tag the release with
git tag v1.2.0.
Connects securely to your tools. The creator never sees your data.
About this skill
Maintaining an accurate CHANGELOG.md is a manual chore that often leads to stale documentation or vague release notes. This skill automates the extraction and categorization of git history into a structured format following the Keep a Changelog standard.
What it does
- Automatic categorization sorts commits into Added, Changed, Deprecated, Removed, Fixed, and Security sections.
- Conventional Commit parsing uses prefixes like
featorfixto determine entry placement. - Breaking change detection identifies
!markers and footers to highlight breaking updates. - Link generation creates compare links between versions if a remote repository is configured.
- Duplicate filtering skips merge commits and redundant version entries to keep logs clean.
How it works
- Context check verifies the working directory is a valid git repository.
- Version selection uses a user-provided version string or defaults to an Unreleased section.
- Execution runs the bundled
changelog.shscript with optional flags for range, output, or overwrite. - Validation reports if no commits are found in the specified range instead of inventing data.
Frameworks & tools
This skill utilizes git, bash, and standard CHANGELOG.md conventions. It works with any project using Git for version control and prefers repositories following Conventional Commits.
Why this beats prompting it yourself
Writing changelogs manually or via generic prompts often results in inconsistent formatting and missed commits. This skill uses a deterministic script to ensure reproducible results and strict adherence to specific categorization rules.
Use cases
- Generate release notes for a new version tag.
- Maintain a live Unreleased section during active development.
- Backfill a project history into a single structured file using the
--allflag. - Audit recent changes before a production deployment.
Known limitations
Requires a local git environment and bash to run the bundled script. It refuses to edit existing release sections to prevent accidental data loss.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Technical Documentation.
Requires git and bash. Will not overwrite existing version sections without the explicit overwrite flag. Logic depends on commit message quality.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 5 days ago
- Free with an Agensi account
- Software
Git
Node.js