| name | bk-version |
| description | BlueKiwi version management skill. Lists all versions of a workflow family, activates or deactivates specific versions, and compares versions. This skill should be used when the user says "/bk-version", "manage versions", "switch version", "see version history", or wants to handle workflow versioning in BlueKiwi. |
| user_invocable | true |
Asking questions across runtimes: wherever this skill says
AskUserQuestion, use your host runtime's native structured-question
tool: AskUserQuestion (Claude Code), clarify (Hermes Agent),
requestUserInput (Codex CLI), question (opencode). Always present
the choices through that tool rather than plain prose. If the runtime
has no such tool, list the options as numbered text and wait for the
user's reply before proceeding.
BlueKiwi Version Management
View, compare, activate, and manage versions of a workflow family.
Argument Handling
/bk-version → Select a workflow and show its version history./bk-version <workflow name> → Load version history for the named workflow directly.
Core Concepts
- A workflow family shares the same root. All versions created via
create_new_version: true are members of the same family.
- Only one version per family can be active at a time. Activating a version automatically deactivates the previous active one.
- Inactive (archived) versions are readable but cannot be started with
start_workflow.
Execution Steps
Step 1: Select Workflow
If no argument, call list_workflows and ask via AskUserQuestion:
- header: "Which workflow?"
- options: workflow title list (up to 4)
Step 2: Load Version History
Call list_workflow_versions for the selected workflow ID.
Display the version list:
Workflow versions: {title}
━━━━━━━━━━━━━━━━━━━━━━━━━
v1.0 (ID: 12) ✅ Active created 2026-04-10
v1.1 (ID: 15) 🗄️ Archived created 2026-04-11
v2.0 (ID: 18) 🗄️ Archived created 2026-04-12
━━━━━━━━━━━━━━━━━━━━━━━━━
Active: v1.0
Step 3: Select Action
Ask via AskUserQuestion:
- header: "Version action"
- options: ["Activate a version", "Deactivate current", "Compare two versions", "Cancel"]
Action: Activate
Ask which version to activate via AskUserQuestion (show archived versions as options).
Confirm:
Activate v<x.y> (ID: <id>)?
This will deactivate the current active version v<current>.
Call activate_workflow with the selected workflow_id.
Action: Deactivate Current
Confirm via AskUserQuestion:
- "Deactivate the current active version v? No version will be active until you reactivate one."
- options: ["Deactivate", "Cancel"]
Call deactivate_workflow.
Action: Compare Two Versions
Ask the user to select two versions to compare via AskUserQuestion.
Fetch both workflows and display a side-by-side node comparison:
Comparing v<a> vs v<b>
━━━━━━━━━━━━━━━━━━━━━━━━━
Step 1: [same] Clarify Goal
Step 2: [changed] "Collect keywords" → "Collect top 10 keywords (by search volume)"
Step 3: [added in v<b>] Quantitative Validation
━━━━━━━━━━━━━━━━━━━━━━━━━
