jeremylongshore/tons-of-skills-marketplace / plugins/examples/jeremy-plugin-tool/skills/version-bumper
version-bumper
VerifiedExecute 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.
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
jqinstalled and available on PATH for JSON manipulation- Read/write access to
.claude-plugin/plugin.jsonand.claude-plugin/marketplace.extended.json pnpm run sync-marketplaceavailable 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.jsonusingjq -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.patchcomponents and compute the new version according to semver rules (seereferences/version-bump-process.md). - Update the
"version"field in.claude-plugin/plugin.jsonwith the new version string. - Locate the plugin entry in
.claude-plugin/marketplace.extended.jsonand update its"version"field to match (seereferences/update-locations.md). - Run
pnpm run sync-marketplaceat the repository root to regeneratemarketplace.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 thechore: Release v<version>convention (seereferences/release-workflow.md).
Output
A version bump execution summary containing:
- The computed transition (
old_versiontonew_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
references/version-bump-process.md-- step-by-step bump algorithmreferences/update-locations.md-- all files requiring version updatesreferences/release-workflow.md-- full release process including git tagsreferences/examples.md-- additional usage scenarios- Semantic Versioning specification
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |