version-orchestration | sdd | ClaudePluginHub

Skill

version-orchestration

Compares installed SDD plugin version with project version in sdd-settings.yaml, detects mismatches using semver, and displays update guidance.

developer-tools

$

npx claudepluginhub liorcohen/sdd --plugin sdd

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Display the installed SDD plugin version and the project's plugin version, highlighting when the project is outdated.

SKILL.md

Similar Skills

init-orchestration

24

Initializes SDD projects via version detection, plugin rebuild if needed, environment verification, tech pack registration, minimal scaffolding, and git setup.

check-version

11

Checks bopen-tools plugin version against GitHub in ~70ms, returning JSON status (current/outdated/ahead). Use at session start, for update queries, or suspicious skill behavior.

1 file1 tool

update-wizard

16

Smart update for SDLC wizard — shows changelog, compares files, lets you selectively adopt changes while preserving customizations.

Stats

Parent Repo Stars24

Parent Repo Forks0

Last CommitFeb 23, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

project-settings

Help us improve

Share bugs, ideas, or general feedback.

Version Orchestration

Display the installed SDD plugin version and the project's plugin version, highlighting when the project is outdated.

Input

Invoked by sdd-run.md with no arguments.

Preconditions

Plugin is loaded (agent has access to plugin root path)

Flow

Read the installed plugin version from <plugin-root>/.claude-plugin/plugin.json → version field
Check if sdd/sdd-settings.yaml exists in the current directory
If it exists, read the project plugin version from sdd.updated_by_plugin_version (with fallback to legacy sdd.plugin_version for pre-reconciliation files)
Optionally read sdd.initialized_by_plugin_version for context (the version that first created the project)
Compare versions using semver:
- Match — installed and project versions are the same
- Project outdated — project version is older than installed version (the common case after a plugin upgrade)
- Project newer — project version is newer than installed (unusual — may indicate a downgraded plugin)
Display the version report

Output Scenarios

When versions match

SDD Plugin

  Installed:       6.5.0
  Project:         6.5.0  ✓ match
  Originally from: 6.2.0

When project is outdated (installed is newer)

SDD Plugin

  Installed:       6.5.0
  Project:         6.2.0  ⚠ outdated
  Originally from: 6.0.0

The project settings were last reconciled with an older plugin version.
  /sdd I want to initialize a new project

When project is newer than installed (unusual)

SDD Plugin

  Installed:       6.3.0
  Project:         6.5.0  ⚠ installed plugin is older than project
  Originally from: 6.0.0

The installed plugin is older than what this project expects.
Run: claude plugins update sdd

When not inside an SDD project

SDD Plugin

  Installed:  6.5.0
  Project:    (no SDD project detected)

NEXT STEPS:
  /sdd I want to initialize a new project

Related

project-settings skill - Owns the sdd-settings.yaml schema

Output

Returns the version report as formatted text.