Bump Version

SkillAI & models

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

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Bump Version skill

What this skill tells your AI

The instructions your AI receives, as published by sd0xdev/sd0x-harness in skills/bump-version/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
188
Forks
24
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
bump-version-sd0xdev
Source
github.com/sd0xdev/sd0x-harness