Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release.

MITAuto-check passedAgent Workflows

Install Version Bumper

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill version-bumper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace version-bumper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/version-bumper .claude/skills/version-bumper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
version-bumper
GitHub stars
2.8k
Token cost
~1.1k tokens
SKILL.md length
449 words
Files
11 (incl. scripts, references, assets)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release.

  • Works in 8 steps: Identify the target plugin directory and… → Determine the bump type (major, minor,… → Parse the current version into its… → …
  • Mentions version bump
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Calls git, pnpm and jq

What it does

Version Bumper is an agent skill from jeremylongshore/tons-of-skills-marketplace. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts, reference files and assets (for example `assets/README.md`, `references/ARD.md` and `references/PRD.md`). Compatibility notes: Designed for Claude Code

It sits in Agent Workflows, covering Hooks and plugins. It works with Git. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Mentions version bump
  • Appropriate context detected
  • With relevant phrases based on skill purpose

Example prompts

  • “/version-bumper”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Bash(cmd:*)

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Identify the target plugin directory and read the current version from .claude-plugin/plugin.json using jq -r '.version'.
  2. Determine the bump type (major, minor, or patch) from the user request. If unspecified, infer from the nature of changes: breaking changes…
  3. Parse the current version into its major.minor.patch components and compute the new version according to semver rules (see…
  4. Update the "version" field in .claude-plugin/plugin.json with the new version string.
  5. Locate the plugin entry in .claude-plugin/marketplace.extended.json and update its "version" field to match (see…
  6. Run pnpm run sync-marketplace at the repository root to regenerate marketplace.json.
  7. Verify version consistency across all three files by reading each and confirming the version strings match.
  8. Optionally create a git tag (git tag -a "v" -m "Release v") and prepare a commit message following the chore: Release v convention (see…

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Bash(cmd:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • pnpm
    • jq
    • apt
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • semver.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Version Bumper loads about 1.1k tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 449 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 449 words, ~1,135 tokens.

Download SKILL.mdSave it as .claude/skills/version-bumper/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
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.
allowed-tools
Read, Write, Edit, Grep, Bash(cmd:*)
compatibility
Designed for Claude Code
version
2.20.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
example, version-bumper

Version Bumper

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

  1. Identify the target plugin directory and read the current version from .claude-plugin/plugin.json using jq -r '.version'.
  2. 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.
  3. 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).
  4. Update the "version" field in .claude-plugin/plugin.json with the new version string.
  5. 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).
  6. Run pnpm run sync-marketplace at the repository root to regenerate marketplace.json.
  7. Verify version consistency across all three files by reading each and confirming the version strings match.
  8. 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)
Show full SKILL.md (197 more words)Show less

Error Handling

ErrorCauseSolution
jq: command not foundjq not installedInstall via apt install jq or brew install jq
Version format invalidNon-semver string in plugin.jsonCorrect to x.y.z format before bumping
Plugin not found in marketplaceMissing catalog entryAdd the plugin to marketplace.extended.json first
Sync marketplace failureSchema mismatch or missing fieldsRun jq empty on both JSON files to locate syntax errors
Version mismatch after syncsync-marketplace did not pick up changesVerify 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

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files (scripts, references, assets) in skills/.curated/version-bumper of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • assets/README.md
  • references/ARD.md
  • references/PRD.md
  • references/README.md
  • references/errors.md
  • references/examples.md
  • references/release-workflow.md
  • references/update-locations.md
  • references/version-bump-process.md
  • scripts/README.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Version Bumper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Version Bumper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Version Bumper this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Compound Engineering SetupEveryInc/compound-engineering-plugin25k—~2kAutomated safety check: PassMIT
Readyprekuter/dryforge4131 repos~6.8kAutomated safety check: PassApache-2.0
Command Creatormeshery/meshery-operator1514 repos~1.7kAutomated safety check: PassApache-2.0
Migrationprekuter/dryforge4131 repos~3.2kAutomated safety check: PassApache-2.0
Goprekuter/dryforge4131 repos~7.2kAutomated safety check: PassApache-2.0

Similar skills

  • Compound Engineering Setup

    EveryInc/compound-engineering-plugin

    Checks Compound Engineering plugin health and repo-local config, or scaffolds a Compound Pack when you ask for one by id.

    25k GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Ready

    prekuter/dryforge

    Understand what you mean before anything is built. An agent skill from prekuter/dryforge.

    413 GitHub starsUsed in 1 repo~6.8k tokens
    Agent WorkflowsAuto-check passed
  • Command Creator

    meshery/meshery-operator

    This skill should be used when creating a Claude Code slash command.

    151 GitHub starsUsed in 4 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • Migration

    prekuter/dryforge

    Bring an existing codebase into Dryforge, once. An agent skill from prekuter/dryforge.

    413 GitHub starsUsed in 1 repo~3.2k tokens
    Agent WorkflowsAuto-check passed
  • Go

    prekuter/dryforge

    Carry out the intent approved in ready, as meant, and prove it with checks that actually ran.

    413 GitHub starsUsed in 1 repo~7.2k tokens
    Agent WorkflowsAuto-check passed
  • Watchmen Setup

    firstbatchxyz/watchmen

    Walks through installing watchmen, running its init wizard, wiring the plugin into Codex or Claude Code and checking the result with doctor.

    296 GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check: notes

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Version Bumper

What does Version Bumper do?

Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release. Version Bumper is an agent skill from jeremylongshore/tons-of-skills-marketplace.json and marketplace catalog when user mentions version bump, update version, or release.

When should I use Version Bumper?

Version Bumper fits situations like: mentions version bump; appropriate context detected; with relevant phrases based on skill purpose.

How do I install Version Bumper in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill version-bumper -a claude-code`. Or copy the skill folder (skills/.curated/version-bumper in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/version-bumper in your project. Claude Code loads it when a task matches its description.

How do I install Version Bumper in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill version-bumper -a codex`. Or copy the skill folder (skills/.curated/version-bumper in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/version-bumper in your project. Codex loads it when a task matches its description.

Can I use Version Bumper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill version-bumper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/version-bumper, .gemini/skills/version-bumper, .github/skills/version-bumper and .opencode/skills/version-bumper in your project.

What does Version Bumper need to run?

Going by SKILL.md and its folder, Version Bumper needs the command-line tools its instructions call (git, pnpm, jq, apt and brew). Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Bash(cmd:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Version Bumper access the network?

SKILL.md names 1 domain. As links in the text: semver.org. This is read from the text; nothing was executed.

Is Version Bumper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Version Bumper use?

Version Bumper is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Version Bumper use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Version Bumper?

Skills that share tags, products or a category with Version Bumper: Compound Engineering Setup (EveryInc/compound-engineering-plugin, 25k stars), Ready (prekuter/dryforge, 413 stars), Command Creator (meshery/meshery-operator, 151 stars) and Migration (prekuter/dryforge, 413 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Version Bumper?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.