BU

bump-version

Automates version bumping across package.json and plugin configuration files.

Install

mkdir -p .claude/skills/bump-version-sd0xdev && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11227" && unzip -o skill.zip -d .claude/skills/bump-version-sd0xdev && rm skill.zip

Installs to .claude/skills/bump-version-sd0xdev

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Bump package and plugin version in sync. Updates package.json, .claude-plugin/plugin.json, and install-state manifest to the same version. Use when: user says 'bump version', 'update version', '更新版本', '版本 +1', or /bump-version
226 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Bump package version
  • Update plugin version
  • Sync manifest files

How it works

It updates version fields in package.json, plugin.json, and install-state manifest to ensure synchronization.

Inputs & outputs

You give it
Version increment type
You get back
Updated version fields in all files

When to use bump-version

  • Bump project version
  • Update plugin versioning
  • Sync manifest files
  • Increment minor release versions

About this skill

Bump Version

Update package.json, .claude-plugin/plugin.json, and .sd0x/install-state.json versions in sync.

Workflow

  1. Read current versions from all files
  2. Determine new version (from argument or auto-increment)
  3. Update all files to the same version
  4. Report result

Step 1: Read Current Versions

grep '"version"' package.json .claude-plugin/plugin.json

Also check manifest:

grep '"plugin_version"' .sd0x/install-state.json 2>/dev/null || echo "(no manifest)"

If versions are already out of sync, warn user before proceeding.

Step 2: Determine New Version

InputAction
Explicit version (e.g., 1.9.0)Use as-is
majorBump major: 1.8.12.0.0
minorBump minor: 1.8.11.9.0
patch (default)Bump patch: 1.8.11.8.2
No argumentDefault to patch

Step 3: Update All Files

Use Edit tool to update version fields:

  1. package.json"version" field
  2. .claude-plugin/plugin.json"version" field
  3. .sd0x/install-state.json"plugin_version" field (if file exists)

All must be set to the exact same version string.

The manifest update prevents the SessionStart drift sentinel from firing false warnings after every version bump in the plugin source repo.

Step 4: Report

## Version Bump

| File | Field | Before | After |
|------|-------|--------|-------|
| package.json | version | x.y.z | a.b.c |
| .claude-plugin/plugin.json | version | x.y.z | a.b.c |
| .sd0x/install-state.json | plugin_version | x.y.z | a.b.c |

Prohibited

  • Never set different versions across the files
  • Never modify other fields in the JSON files

When not to use it

  • When versions are already synced

Limitations

  • Files must be in the same repository

How it compares

It prevents version drift across multiple configuration files in a single operation.

Compared to similar skills

bump-version side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
bump-version (this skill)04moReviewBeginner
resolve-conflicts818moReviewIntermediate
openspec-onboard106moReviewBeginner
codex-cli-bridge99moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry