Skills

Version Bump and Release

Bumps plugin versions in every manifest, tags the release and writes the changelog.

Install

npx skills add thedotmack/claude-mem --skill version-bump -g -a claude-code -y
Repository
thedotmack/claude-mem109k
Category
DevOps
Updated
3d ago
License
Apache-2.0
Context cost
Mediumabout 1,562 tokens
Runs scripts
Yes, review before use

What it does

Automated semantic versioning and release workflow for Claude Code plugins. Handles version increments across package.json, marketplace.json, plugin.json manifests, build verification, git tagging, GitHub releases, and changelog generation. npm publishing is done by the tag-triggered GitHub Actions workflow through npm trusted publishing.

Version Bump & Release Workflow

IMPORTANT: Plan and write detailed release notes before starting.

CRITICAL: Commit EVERYTHING (including build artifacts). At the end of this workflow, NOTHING should be left uncommitted or unpushed. Run git status at the end to verify.

Preparation

  1. Analyze: Determine if the change is PATCH (bug fixes), MINOR (features), or MAJOR (breaking).

  2. Environment: Identify repository owner/name from git remote -v.

  3. Paths, every file that carries the version string:

    • package.json, the npm/npx-published version (npx claude-mem@X.Y.Z resolves from this)
    • plugin/package.json, bundled plugin runtime deps
    • .claude-plugin/marketplace.json, version inside plugins[0].version
    • .claude-plugin/plugin.json, top-level Claude-plugin manifest
    • plugin/.claude-plugin/plugin.json, bundled Claude-plugin manifest
    • .codex-plugin/plugin.json, Codex-plugin manifest
    • plugin/.codex-plugin/plugin.json, bundled Codex-plugin manifest
    • .qoder-plugin/plugin.json, Qoder plugin manifest
    • plugin/.qoder-plugin/plugin.json, bundled Qoder plugin manifest
    • openclaw/openclaw.plugin.json, OpenClaw plugin manifest
    • .grok-plugin/plugin.json, Grok plugin manifest
    • claude-mem-cursor/.cursor-plugin/plugin.json, Cursor plugin manifest
    • claude-mem-grok-bot/.cursor-plugin/plugin.json, Grok Bot Cursor plugin manifest
    • dsh/package.json, bundled DSH plugin package
    • README.md, the version badge (version-X.Y.Z-green), not a "version" key

    Verify coverage before editing: git grep -l "\"version\": \"<OLD>\"" should list the fourteen JSON files above, and git grep -n "version-<OLD>-green" the README badge. If a new manifest has been added since this doc was last updated, update this list.

Workflow

Read the whole SKILL.md on GitHub

More in DevOps