Version Bump & Release Workflow
A checklist-driven skill that bumps the version across every manifest, then builds, tags, publishes a GitHub release, and regenerates the changelog.
Dev & CodingIntermediate★ 90,139⑂ 7,846AI score 6/10Last updated: Aug 9, 2026
What it does
Walks an agent through the full semantic-versioning release process for a Claude Code plugin repo (modeled on claude-mem):
- Classifies the change as PATCH / MINOR / MAJOR
- Bumps the version string in eight manifest files (
package.json,.claude-plugin/marketplace.json, severalplugin.jsonvariants, etc.) - Verifies with
git grepthat no old version strings remain - Runs
npm run build-and-syncso artifacts, the local marketplace copy and the worker stay in sync - Commits, creates an annotated tag
vX.Y.Z, pushes both - Refuses to run
npm publish— that step is explicitly handed off to the human maintainer (credentials/2FA) - Creates the GitHub release with
gh, regeneratesCHANGELOG.md, sends a Discord notification, and ends with a cleangit status
Who it's for
- Plugin maintainers who keep shipping mismatched versions across manifests
- Teams that want one canonical release order: build → tag → notes → changelog → announce
- Anyone who wants agent automation but a human gate on npm publishing
Examples
- "Two bug fixes landed — cut a patch release." → bumps 0.9.3 → 0.9.4 across all files, builds, commits/tags/pushes, then stops and asks you to publish.
- "Draft release notes and create the vX.Y.Z GitHub release." → writes notes from the commit log, runs
gh release create, thennpm run changelog:generate. - "Audit whether any file still carries the old version." → runs
git grepand reports manifests that were missed.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugin/skills/version-bump folder from the GitHub repo thedotmack/claude-mem into my ~/.claude/skills/version-bump/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/thedotmack/claude-mem.git /tmp/claude-mem && mkdir -p ~/.claude/skills && cp -r /tmp/claude-mem/plugin/skills/version-bump ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repository:
git clone https://github.com/thedotmack/claude-mem.git /tmp/claude-mem - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/claude-mem/plugin/skills/version-bump ~/.claude/skills/ - Edit
~/.claude/skills/version-bump/SKILL.mdand adjust the file path list, build script name, and Discord notify step for your own project — as shipped it only fits the claude-mem repo. - Restart Claude Code and say something like "bump the version and prepare a release" to trigger the skill.
- Prerequisites:
git, an authenticatedgh(GitHub CLI), and Node/npm installed.
View source on GitHub ↗License: Apache-2.0