agents-standards
Standards for authoring SDD plugin agents — frontmatter, self-containment, skill references, and no-user-interaction rules.
@liorcohenInstall SkillDevelopment
Skill
/version-orchestration
Displays installed and project plugin versions with mismatch detection.
Claude Code
$ npx -y skills add LiorCohen/sdd --skill version-orchestration --agent claude-code
Codex
$ npx skills add LiorCohen/sdd --skill version-orchestration -a codex -y
Cursor
$ npx skills add LiorCohen/sdd --skill version-orchestration -a cursor -y
Gemini CLI
$ npx skills add LiorCohen/sdd --skill version-orchestration -a gemini-cli -y
GitHub Copilot
$ npx skills add LiorCohen/sdd --skill version-orchestration -a github-copilot -y
OpenCode
$ npx skills add LiorCohen/sdd --skill version-orchestration -a opencode -y
Windsurf
$ npx skills add LiorCohen/sdd --skill version-orchestration -a windsurf -y
SKILL.md
version-orchestration.SKILL.mdname: version-orchestration
description: Displays installed and project plugin versions with mismatch detection.
user-invocable: false
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
1. Read the installed plugin version from `<plugin-root>/.claude-plugin/plugin.json` → `version` field 2. Check if `sdd/sdd-settings.yaml` exists in the current directory 3. 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) 4. Optionally read `sdd.initialized_by_plugin_version` for context (the version that first created the project) 5. 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)
6. 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.
Read more
name: version-orchestration description: Displays installed and project plugin versions with mismatch detection. user-invocable: false
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
1. Read the installed plugin version from `<plugin-root>/.claude-plugin/plugin.json` → `version` field 2. Check if `sdd/sdd-settings.yaml` exists in the current directory 3. 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) 4. Optionally read `sdd.initialized_by_plugin_version` for context (the version that first created the project) 5. 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)
6. 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.
Stats
43
Stars
4
Forks
Quiet
Maintenance
TypeScript
Language
Last commit
Created
Ships withsdd
Structure for AI-assisted development AI coding assistants are powerful but chaotic. You prompt, you get code, but then what?
4359 skills7 agents
Stars on GitHub
Momentum
- stars in total
- 43
Other skills on sdd.
@liorcohenInstall Skillcommands-standards
Standards for authoring SDD plugin commands — frontmatter, user interaction, skill/agent invocation, CLI integration, and output…
@liorcohenInstall Skillcommit
Create a commit following repository guidelines with proper versioning and changelog updates.
@liorcohenInstall Skillcritic
Two-step self-review at every task lifecycle phase. Step 1 (this skill) runs in-context to gather session signals — files read vs…
@liorcohenInstall Skilld2
D2 diagramming language reference for architecture diagrams, sequence diagrams, grid layouts, SQL tables, and class diagrams.…
@liorcohenInstall Skilldocs-standards
Writes and maintains user-facing documentation for the SDD plugin. Proactively detects when docs are out of sync with plugin…
@liorcohenInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about version-orchestration.
- Which coding agents can use version-orchestration?
- version-orchestration installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.