---

name: version-bump description: Bump semantic version across all project files (package.json, CLI, README, docs). Use for version updates without full release. allowed-tools:

• Read
• Edit
• Glob
• Grep
• Bash(npm run build)
• Bash(npm test)
• Bash(npm install:*)
• Bash(node:*)
• Bash(echo:*)
• AskUserQuestion user-invocable: false

---

Version Bump Skill

Updates semantic version consistently across all project files. This skill handles version updates only - use /release for the full release workflow including git and npm publishing.

Trigger Words

Use when user says: "bump version", "update version", "version bump", or when called by the release skill.

Version Locations (Canonical List)

These are ALL locations where version numbers appear. Every bump MUST update all of these:

Primary Sources

Documentation

Auto-generated (DO NOT edit manually)

Procedure

Step 1: Determine New Version

Ask user or determine from context:

Or accept explicit version like "2.1.0".

Step 2: Read Current Version

Copynode -p "require('./package.json').version"

Step 3: Update All Locations (IN ORDER)

1. package.json (line 3):

   Copy"version": "NEW_VERSION",
   

2. src/cli/index.ts (line 18):

   Copyconst VERSION = 'NEW_VERSION';
   

3. README.md (line 12):

   Copy> **vNEW_VERSION**: [brief description of changes]
   

4. docs/index.html (line 45):

   Copy"softwareVersion": "NEW_VERSION",
   

Step 4: Update Lock File

Copynpm install --package-lock-only

Step 5: Build

Copynpm run build

Step 6: Verify

Copy# All versions should match
echo "package.json: $(node -p "require('./package.json').version")"
echo "CLI binary:   $(node dist/cli.js --version)"

# Tests should pass
npm test

Verification Checklist

Before completing, verify ALL match the new version:

• package.json version field
• src/cli/index.ts VERSION constant
• README.md version banner
• docs/index.html softwareVersion
• npm run build succeeds
• npm test passes
• node dist/cli.js --version outputs correct version

Semantic Versioning Reference

Examples:

• 2.0.3 + patch = 2.0.4
• 2.0.3 + minor = 2.1.0
• 2.0.3 + major = 3.0.0

Notes

• Never edit package-lock.json manually
• The README version banner should include a brief changelog note
• Always run build and tests after version bump
• This skill does NOT commit changes - use /release for full workflow

Related

Use /release for full release workflow including:

• Version bump (this skill)
• Git commit
• Git tag
• Push to remote
• GitHub release creation
• Automatic npm publish via OIDC