release-bump
Use this skill to finalize a release. It stamps the [Unreleased] changelog section with a version and date, runs bumpversion to update all version files, and creates the release commit and tag. Only run this when you're ready to ship.
Best for Release engineersWorks with GitHub
⌘source
- author
@jamiepine- language
- TypeScript
★21kstars
2.4kforks
Apr 19, 2026
✦overview.md
Key Features
- ·Stamps the [Unreleased] changelog section with version and date
- ·Runs bumpversion to update all tracked version files
- ·Creates a release commit and tag
- ·Verifies clean working tree before proceeding
- ·Handles patch, minor, or major version bumps
Use Cases
- →Finalizing a software release before pushing to production
- →Automating version updates across multiple files
- →Creating a clean, tagged release commit for deployment
Best for
- ✓Release engineers
- ✓CI/CD pipelines
- ✓Teams using semantic versioning
Not ideal for
- !Projects without a CHANGELOG.md file
- !One-off version changes
- !Non-Git repositories
FAQs
name
release-bump
description
Use this skill to finalize a release. It stamps the [Unreleased] changelog section with a version and date, runs bumpversion to update all version files, and creates the release commit and tag. Only run this when you're ready to ship.
Release Bump
Goal
Finalize the changelog draft, bump the version across all tracked files, and create a tagged release commit. After this skill runs, the repo has a clean release commit and tag ready to push.
Prerequisites
ghCLI installed and authenticated (gh auth status).bumpversioninstalled (pip install bumpversionor available in the project venv).- The
[Unreleased]section ofCHANGELOG.mdshould already contain the release narrative. If it's empty or stale, run thedraft-release-notesskill first.
Workflow
-
Verify the working tree is clean (except
CHANGELOG.mdwhich may have the draft).git status --porcelainOnly
CHANGELOG.md(and optionally.agents/files) should be modified. If there are other uncommitted changes, stop and ask the user to commit or stash them first. -
Determine the bump level.
Ask the user if not specified:
patch,minor, ormajor. Check the current version:grep '^current_version' .bumpversion.cfg -
Stamp the changelog.
$install
1-click copynpx skills add jamiepine/voicebox --skill release-bumpSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.