Skill
agents-standards
Standards for authoring SDD plugin agents — frontmatter, self-containment, skill references, and no-user-interaction rules.
@liorcohenView SkillDevelopment
Skill
/version-orchestration
Displays installed and project plugin versions with mismatch detection.
Install
$ npx -y skills add LiorCohen/sdd --skill version-orchestration --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/version-orchestration
Context preview
The summary Claude sees to decide when to auto-load this skill.
Displays installed and project plugin versions with mismatch detection.
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.
Ships withsdd
Structure for AI-assisted development AI coding assistants are powerful but chaotic. You prompt, you get code, but then what?
Get the whole plugin
Stats
44
Stars
4
Forks
Quiet
Maintenance
TypeScript
Language
7mo ago
Last commit
10mo ago
Created
Repo: LiorCohen/sdd
Other skills on sdd.
@liorcohenView SkillSkill
commands-standards
Standards for authoring SDD plugin commands — frontmatter, user interaction, skill/agent invocation, CLI integration, and output formatting.
@liorcohenView SkillSkill
commit
Create a commit following repository guidelines with proper versioning and changelog updates.
@liorcohenView SkillSkill
critic
Two-step self-review at every task lifecycle phase. Step 1 (this skill) runs in-context to gather session signals — files read vs grepped, user pushback, build…
@liorcohenView SkillSkill
d2
D2 diagramming language reference for architecture diagrams, sequence diagrams, grid layouts, SQL tables, and class diagrams. Produces .d2 files rendered via…
@liorcohenView SkillSkill
docs-standards
Writes and maintains user-facing documentation for the SDD plugin. Proactively detects when docs are out of sync with plugin capabilities.
@liorcohenView Skill