Version Bump & Release Workflow
A step-by-step release runbook that syncs the version across every manifest, builds, tags, publishes a GitHub release, regenerates the changelog, and notifies Discord.
Dev & CodingIntermediate★ 90,139⑂ 7,846AI score 5/10Last updated: Aug 9, 2026
What it does
- Classifies the change as PATCH / MINOR / MAJOR before touching anything.
- Bumps the version string in eight manifest files (
package.json,.claude-plugin/marketplace.json, the variousplugin.jsonfiles) and verifies coverage withgit grep. - Runs
npm run build-and-sync, commits everything (including build artifacts), tags, pushes, creates the GitHub release withgh, regeneratesCHANGELOG.md, fires a Discord notification, and ends with a cleangit status. - Explicitly hands
npm publishoff to the human maintainer (credentials/2FA), so the agent never publishes on its own.
Who it's for
- Maintainers of the claude-mem repository itself.
- Plugin/monorepo owners whose version string lives in many manifests and who keep missing one at release time (paths and script names must be adapted).
- Teams that want their release process encoded as an executable checklist rather than prose docs.
Example uses
- "Ship a patch release" after merging bug fixes — the skill updates all eight files, builds, tags, pushes, and opens the GitHub release, then pauses for the human npm publish.
- Cutting a minor release: draft release notes first, then regenerate the changelog with
npm run changelog:generateand push it. - Auditing a suspicious release: run
git grep -n "\"version\": \"<OLD>\""to prove zero stale version strings remain.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/thedotmack/claude-mem/HEAD/plugin/skills/version-bump/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
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 && mkdir -p ~/.claude/skills && cp -r 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 repo:
git clone https://github.com/thedotmack/claude-mem.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r claude-mem/plugin/skills/version-bump ~/.claude/skills/ - Edit
~/.claude/skills/version-bump/SKILL.mdand replace project-specific bits: the eight manifest paths, thebuild-and-sync/changelog:generatescript names, and the~/Scripts/claude-mem/Discord notifier path. - Make sure
gh(GitHub CLI) is authenticated and you have npm publish rights. - Restart Claude Code and try: "use the version bump workflow to release vX.Y.Z".
View source on GitHub ↗License: Apache-2.0