plugin-bump

Bump plugin.json versions using jq with semantic versioning rules.

42|2|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/robbyt/claude-skills --skill plugin-bump
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-bump
Source: https://github.com/robbyt/claude-skills/tree/main/.claude/skills/plugin-bump
Command: npx skills add https://github.com/robbyt/claude-skills --skill plugin-bump

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bump a plugin version in plugins/PLUGIN_NAME/.claude-plugin/plugin.json following semantic versioning.

Core Features & Use Cases

  • Inference rules: Major, Minor, Patch bump decisions based on context.
  • Command example: Apply a patch bump to a plugin.json version.

Quick Start

jq '.version |= (split(".") | .[2] = ((.[2] | tonumber) + 1 | tostring) | join("."))' plugins/PLUGIN_NAME/.claude-plugin/plugin.json > /tmp/c

Frequently Asked Questions about plugin-bump

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bump a plugin version using semantic versioning?

Semantic versioning bumps a plugin version by incrementing the major, minor, or patch number in plugin.json. Use this Skill to automatically update the version following semver rules—patch for bug fixes, minor for new features, major for breaking changes—without manually editing the JSON file.

When should I use major, minor, or patch version bumps?

Patch bumps fix bugs, minor bumps add backward-compatible features, and major bumps introduce breaking changes. This Skill infers the correct bump level based on the type of change you've made to your plugin, then updates plugin.json accordingly.

Can I automate version bumps after plugin changes?

Yes. This Skill automates version bumping in plugins/PLUGIN_NAME/.claude-plugin/plugin.json by detecting what changed and applying the appropriate semver increment, eliminating manual JSON edits.

What file format does this Skill modify?

This Skill modifies plugin.json, the configuration file stored in plugins/PLUGIN_NAME/.claude-plugin/ that contains your plugin's version metadata and other settings.

Do I need to know jq to use this Skill?

No. This Skill handles jq commands internally to parse and update plugin.json. You request a version bump and the Skill applies semantic versioning rules and returns the updated version.

Can I bump versions across multiple plugins at once?

This Skill bumps one plugin version per invocation by targeting plugins/PLUGIN_NAME/.claude-plugin/plugin.json. For multiple plugins, invoke it separately for each plugin directory.