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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| assets/README.md | markdown | 526 B |
| references/ARD.md | markdown | 4.0 KB |
| references/PRD.md | markdown | 3.4 KB |
| references/README.md | markdown | 581 B |
| references/errors.md | markdown | 319 B |
| references/examples.md | markdown | 925 B |
| references/release-workflow.md | markdown | 725 B |
| references/update-locations.md | markdown | 497 B |
| references/version-bump-process.md | markdown | 969 B |
| scripts/README.md | markdown | 623 B |
SKILL.md
View on 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:*)
version: 2.21.0
author: Jeremy Longshore <jeremy@intentsolutions.io>
license: MIT
tags:
- example
- version-bumper
compatibility: Designed for Claude Code
---
# 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 [`references/version-bump-process.md`](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 [`references/update-locations.md`](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 [`references/release-workflow.md`](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
- [`references/version-bump-process.md`](references/version-bump-process.md) -- step-by-step bump algorithm
- [`references/update-locations.md`](references/update-locations.md) -- all files requiring version updates
- [`references/release-workflow.md`](references/release-workflow.md) -- full release process including git tags
- [`references/examples.md`](references/examples.md) -- additional usage scenarios
- [Semantic Versioning specification](https://semver.org/)
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 | Verified | 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: 323k | 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: 323k | 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: 323k | Updated | Claude CodeCodex | Verified | Install |