About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/version-bumper/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill version-bumper. Copyright stays with the author (MIT).

Version Bumper

Name: version-bumper
Author: jeremylongshore

Overview

Automates semantic version bumps across all version-bearing files in a Claude Code plugin. Ensures consistency between plugin.json, marketplace.extended.json, and the generated marketplace.json catalog.

Prerequisites

jq installed and available on PATH for JSON manipulation
Read/write access to .claude-plugin/plugin.json and .claude-plugin/marketplace.extended.json
pnpm run sync-marketplace available at the repository root
Git installed for optional tag creation

Instructions

Identify the target plugin directory and read the current version from .claude-plugin/plugin.json using jq -r '.version'.
Determine the bump type (major, minor, or patch) from the user request. If unspecified, infer from the nature of changes: breaking changes warrant major, new features warrant minor, and fixes warrant patch.
Parse the current version into its major.minor.patch components and compute the new version according to semver rules (see ${CLAUDE_SKILL_DIR}/references/version-bump-process.md).
Update the "version" field in .claude-plugin/plugin.json with the new version string.
Locate the plugin entry in .claude-plugin/marketplace.extended.json and update its "version" field to match (see ${CLAUDE_SKILL_DIR}/references/update-locations.md).
Run pnpm run sync-marketplace at the repository root to regenerate marketplace.json.
Verify version consistency across all three files by reading each and confirming the version strings match.
Optionally create a git tag (git tag -a "v<new_version>" -m "Release v<new_version>") and prepare a commit message following the chore: Release v<version> convention (see ${CLAUDE_SKILL_DIR}/references/release-workflow.md).

Output

A version bump execution summary containing:

The computed transition (old_version to new_version)
The exact files updated: .claude-plugin/plugin.json, .claude-plugin/marketplace.extended.json, and regenerated .claude-plugin/marketplace.json
Validation confirmation that all files carry the same version
Suggested next commands (git add, git commit, git tag, validation scripts)

Error Handling

Error	Cause	Solution
`jq: command not found`	`jq` not installed	Install via `apt install jq` or `brew install jq`
Version format invalid	Non-semver string in plugin.json	Correct to `x.y.z` format before bumping
Plugin not found in marketplace	Missing catalog entry	Add the plugin to `marketplace.extended.json` first
Sync marketplace failure	Schema mismatch or missing fields	Run `jq empty` on both JSON files to locate syntax errors
Version mismatch after sync	`sync-marketplace` did not pick up changes	Verify the plugin name in `marketplace.extended.json` matches `plugin.json` exactly

Examples

Patch bump for a specific plugin: Trigger: "Bump the security-scanner plugin to patch version" Process: Read current version 1.2.3, compute 1.2.4, update plugin.json and marketplace.extended.json, run sync, verify consistency, report success.

Explicit major release: Trigger: "Release version 2.0.0 of plugin-name" Process: Set version to 2.0.0 in all files, sync marketplace, create git tag v2.0.0, prepare commit with chore: Release v2.0.0.

Feature-based minor bump: Trigger: "Increment version for new feature" Process: Detect minor bump, compute 1.2.3 to 1.3.0, update all version locations, sync, validate, report completion.

Resources

${CLAUDE_SKILL_DIR}/references/version-bump-process.md -- step-by-step bump algorithm
${CLAUDE_SKILL_DIR}/references/update-locations.md -- all files requiring version updates
${CLAUDE_SKILL_DIR}/references/release-workflow.md -- full release process including git tags
${CLAUDE_SKILL_DIR}/references/examples.md -- additional usage scenarios
Semantic Versioning specification

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-version-bumper/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-version-bumper.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-version-bumper",
  "kind": "skill",
  "name": "version-bumper",
  "description": "Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release. ensures version consistency in AI assistant-code-plugins repository. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "example",
      "version-bumper",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release. ensures version consistency in AI assistant-code-plugins repository. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/version-bumper/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/version-bumper/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/version-bumper/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Grep,",
      "Bash(cmd:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Version Bumper\n\n## Overview\n\nAutomates semantic version bumps across all version-bearing files in a Claude Code plugin. Ensures consistency between `plugin.json`, `marketplace.extended.json`, and the generated `marketplace.json` catalog.\n\n## Prerequisites\n\n- `jq` installed and available on PATH for JSON manipulation\n- Read/write access to `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.extended.json`\n- `pnpm run sync-marketplace` available at the repository root\n- Git installed for optional tag creation\n\n## Instructions\n\n1. Identify the target plugin directory and read the curre",
  "cost": {
    "context_tokens": 989
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-version-bumper/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.