sync-versions

Sync Versions

Bump a plugin's version atomically across all locations where version is tracked.

Usage

/skill-maintainer:sync-versions <plugin-name> <version>

Examples:

/skill-maintainer:sync-versions tui-design 0.3.0
/skill-maintainer:sync-versions skill-dashboard 1.1.0
/skill-maintainer:sync-versions          # interactive: pick plugin + version

Step 1 -- Determine target plugin and version

If arguments were passed, parse <plugin-name> <version> from them.

Otherwise, run the skill-dashboard version alignment check or list all plugins with their current versions, then ask:

1. Which plugin to bump
2. What version to bump to

Read the current version from the plugin's .claude-plugin/plugin.json to confirm the starting point.

Step 2 -- Validate

• Version must be valid semver (X.Y.Z)
• Version must be higher than current (or equal, to force re-sync without bump)
• Do NOT bump major version without explicit user confirmation
• Confirm the plugin directory exists

Step 3 -- Find and update all version sources

For the target plugin, update version in every file that tracks it:

3a. plugin.json

The plugin's .claude-plugin/plugin.json:

"version": "X.Y.Z"

3b. marketplace.json

Root .claude-plugin/marketplace.json -- find the entry by plugin name:

"version": "X.Y.Z"

3c. Primary SKILL.md

The skill whose directory name matches the plugin name (e.g., skills/<plugin>/skills/<plugin>/SKILL.md or apps/<plugin>/skills/<plugin>/SKILL.md). Update metadata.version in frontmatter:

metadata:
  version: X.Y.Z

3d. pyproject.toml (if present)

If the plugin has a pyproject.toml, update:

version = "X.Y.Z"

Step 4 -- Update last_verified

Set metadata.last_verified to today's date (YYYY-MM-DD) in the primary SKILL.md.

Step 5 -- Report

List exactly what was changed:

Version bumped: mece-decomposer 0.3.0 -> 0.4.0

Updated files:
  - apps/mece-decomposer/.claude-plugin/plugin.json
  - .claude-plugin/marketplace.json (mece-decomposer entry)
  - apps/mece-decomposer/skills/mece-decomposer/SKILL.md (metadata.version, last_verified)
  - apps/mece-decomposer/pyproject.toml

Skipped (not found):
  - (none)

Guardrails

• Atomic -- update all sources or none (if any edit fails, stop and report)
• No major bumps without explicit user confirmation
• Do not commit -- the user decides when to commit
• Equal version allowed -- passing the current version re-syncs all sources without bumping (fixes drift)