session-orchestrator 5.1.0 → 5.2.0

package/.cursor/commands/debug.md

@@ -1,14 +1,14 @@
 ---
-description: "Run a 4-phase systematic debugging investigation before proposing any fix. Iron Law — NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference."
+description: "Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging process before proposing any fix. Iron Law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference."
 argument-hint: "[bug-description-or-issue-ref]"
 ---
 
 # /debug
 
-Use the Session Orchestrator command definition at `commands/debug.md`.
+Use the Session Orchestrator skill definition at `skills/debug/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/discovery.md

@@ -1,14 +1,14 @@
 ---
-description: Systematic quality discovery and issue detection
+description: "Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the project's tech stack, presents findings interactively for user triage, and creates VCS issues for confirmed problems. Invoked standalone via /discovery or embedded in session-end."
 argument-hint: "[all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]"
 ---
 
 # /discovery
 
-Use the Session Orchestrator command definition at `commands/discovery.md`.
+Use the Session Orchestrator skill definition at `skills/discovery/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/dispatcher.md

@@ -1,14 +1,14 @@
 ---
-description: "Pick the next-best repo to work on across the portfolio — rank free repos, recommend one, claim its lease atomically, and route to the entry command"
+description: "Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates candidate repos below the confinement root, resolves free/busy from each repo's session.lock lease, ranks the FREE ones by backlog priority × staleness × readiness, recommends the single most worthwhile one via AskUserQuestion, atomically claims it, and routes you to the chosen entry command. Triggers: \"what should I work on next\", \"dispatch me to a repo\", \"pick the next project\", \"run /dispatcher\". <example>Context: operator finished a session and wants the next-best repo across the portfolio. user: \"/dispatcher\" assistant: \"Ranked 18 free repos — top recommendation: Pencil-Designs (score 4.50, 90d stale). Confirm via the picker, I'll claim its lease atomically, then route you to /session deep.\"</example>"
 argument-hint: "[--dry-run] [--repo <name>]"
 ---
 
 # /dispatcher
 
-Use the Session Orchestrator command definition at `commands/dispatcher.md`.
+Use the Session Orchestrator skill definition at `skills/dispatcher/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/eli5.md

@@ -1,14 +1,14 @@
 ---
-description: "Say the last answer again in plain words — same facts, in the order the operator needs them. Optional topic argument."
+description: "Explain a topic like I'm a 5 year old — restate my last output, or a named topic, in plain words without dropping a single fact. Use when the user types /eli5 [topic], or says an answer was too technical, too long, or unclear about what he now has to do."
 argument-hint: "[topic]"
 ---
 
 # /eli5
 
-Use the Session Orchestrator command definition at `commands/eli5.md`.
+Use the Session Orchestrator skill definition at `skills/eli5/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/eval.md

@@ -1,14 +1,14 @@
 ---
-description: "Run an honest session-process evaluation (Standard v1, aiat-llm-eval/1.0) — score the last completed session against the pre-registered rubric-v1 dimensions"
+description: "Use this skill to run an honest session-process evaluation (Standard v1, aiat-llm-eval/1.0) — score the last completed orchestrator session against the pre-registered rubric-v1 dimensions, run /eval, evaluate this session, produce an eval report, or re-verify a stored eval run for reproducibility. Deterministic-first with an optional advisory LLM judge; never produces a global score."
 argument-hint: "[--session <id>] [--no-write] [--verify <run-id>]"
 ---
 
 # /eval
 
-Use the Session Orchestrator command definition at `commands/eval.md`.
+Use the Session Orchestrator skill definition at `skills/eval/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/evolve.md

@@ -1,14 +1,14 @@
 ---
-description: Extract session patterns into reusable learnings
+description: "Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session history), review (edit/manage existing learnings), list (display active learnings). Manages .orchestrator/metrics/learnings.jsonl."
 argument-hint: "[analyze|review|list|dialectic [--apply]]"
 ---
 
 # /evolve
 
-Use the Session Orchestrator command definition at `commands/evolve.md`.
+Use the Session Orchestrator skill definition at `skills/evolve/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/go.md

@@ -1,14 +1,15 @@
 ---
 description: Approve session plan and begin wave execution
 argument-hint: "[optional instructions]"
+disable-model-invocation: true
 ---
 
 # /go
 
-Use the Session Orchestrator command definition at `commands/go.md`.
+Use the Session Orchestrator skill definition at `skills/go/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/grill.md

@@ -1,14 +1,14 @@
 ---
-description: "Stress-test a plan, design, or PRD before any build — relentless one-question-at-a-time interrogation that hunts contradictions against the code and challenges assumptions. Composable; no HARD-GATE."
+description: "Use when the user wants a plan, design, or PRD stress-tested before any build — relentlessly interrogates one decision at a time, grounds every question in the codebase, hunts contradictions against the domain language and the code, and challenges the load-bearing assumptions. Triggered by \"grill me\", \"stress-test this plan\", \"poke holes in my design\". Composable — run standalone or as an adversarial pass before /plan feature."
 argument-hint: "[file-path-or-topic]"
 ---
 
 # /grill
 
-Use the Session Orchestrator command definition at `commands/grill.md`.
+Use the Session Orchestrator skill definition at `skills/grill/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/harness-audit.md

@@ -4,10 +4,10 @@ description: Run the harness audit and report the rubric score for this reposito
 
 # /harness-audit
 
-Use the Session Orchestrator command definition at `commands/harness-audit.md`.
+Use the Session Orchestrator skill definition at `skills/harness-audit/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/memory-cleanup.md

@@ -1,14 +1,14 @@
 ---
-description: "Manual memory consolidation — review, consolidate, and prune memory files (Dream-equivalent)"
+description: "Use this skill when performing manual memory consolidation (Dream-equivalent). Reviews, consolidates, and prunes memory files under ~/.claude/projects/*/memory/. Run after major refactors, every 5+ sessions, or when memory quality degrades (broken links, stale references, contradictions, MEMORY.md > 200 lines). Invoke with /memory-cleanup."
 argument-hint: "[--dry-run | --apply-pending]"
 ---
 
 # /memory-cleanup
 
-Use the Session Orchestrator command definition at `commands/memory-cleanup.md`.
+Use the Session Orchestrator skill definition at `skills/memory-cleanup/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/npm-publish.md

@@ -0,0 +1,13 @@
+---
+description: "Use when publishing this package to npm — a version release (npm publish), verifying the registry/pi.dev listing, or diagnosing npm auth failures (E403 2FA/token errors). Token-based flow via NPM_TOKEN in .env.local with a temp userconfig, the leakage gate before every publish, post-publish verification and marker/badge upkeep. Trigger on \"publish to npm\", \"npm release\", \"E403 publish error\"."
+---
+
+# /npm-publish
+
+Use the Session Orchestrator skill definition at `skills/npm-publish/SKILL.md`.
+
+Arguments: $ARGUMENTS
+
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/persona-panel.md

@@ -1,14 +1,14 @@
 ---
-description: Run a parallel multi-persona domain-expert review panel against a file, directory, or output range
+description: "Use this skill when you need multi-persona parallel content review — domain experts, buyer personas, compliance reviewers, or custom catalog entries reviewing a target file or output. Dispatches N persona agents in parallel, consolidates verdicts via a configurable mode (voting-quorum, hard-gate-threshold, or coordinator-summary), and writes a timestamped sidecar to .orchestrator/persona-panel/. Invoked via /persona-panel <target-path>."
 argument-hint: "<target> [--personas <names,...>] [--mode <voting|hard-gate|summary>] [--threshold <M-of-N|all|any>] [--grounding <off|re-derive>] [--dry-run]"
 ---
 
 # /persona-panel
 
-Use the Session Orchestrator command definition at `commands/persona-panel.md`.
+Use the Session Orchestrator skill definition at `skills/persona-panel/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/plan.md

@@ -1,14 +1,15 @@
 ---
-description: Plan a new project, feature, or retrospective with structured requirement gathering
+description: "Use this skill when performing structured project planning and PRD generation with three modes: new (project kickoff with repo scaffolding), feature (compact feature PRD), retro (data-driven retrospective). All modes share a researched Q&A engine that dispatches parallel Explore agents before each question wave, presents options via AskUserQuestion with recommendations, and produces documents with prioritized issue creation."
 argument-hint: "[new|feature|retro]"
+disable-model-invocation: true
 ---
 
 # /plan
 
-Use the Session Orchestrator command definition at `commands/plan.md`.
+Use the Session Orchestrator skill definition at `skills/plan/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/portfolio.md

@@ -5,10 +5,10 @@ argument-hint: "[--dry-run] [--repo <name>]"
 
 # /portfolio
 
-Use the Session Orchestrator command definition at `commands/portfolio.md`.
+Use the Session Orchestrator skill definition at `skills/portfolio/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/reconcile.md

@@ -1,14 +1,14 @@
 ---
-description: "Reconcile learnings into .claude/rules/ proposals — on-demand version of session-end Phase 3.6.8"
+description: Use this skill when the user wants to reconcile learnings into rules, run /reconcile, propose rules from learnings, turn learnings into .claude/rules/ entries, or review what rules would be generated from current session learnings. On-demand version of session-end Phase 3.6.8.
 argument-hint: "[--dry-run]"
 ---
 
 # /reconcile
 
-Use the Session Orchestrator command definition at `commands/reconcile.md`.
+Use the Session Orchestrator skill definition at `skills/reconcile/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/release.md

@@ -1,14 +1,15 @@
 ---
 description: "Cut a release — the order the steps must run in, and the criteria that abort a release"
 argument-hint: "[X.Y.Z]"
+disable-model-invocation: true
 ---
 
 # /release
 
-Use the Session Orchestrator command definition at `commands/release.md`.
+Use the Session Orchestrator skill definition at `skills/release/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/repo-audit.md

@@ -1,13 +1,13 @@
 ---
-description: Run a 9-category baseline compliance audit on the current repository
+description: "Use this skill when the user wants to audit a repository for baseline compliance, check code quality, security posture, CI/CD setup, testing, documentation, and ecosystem configuration. Runs 9 checklist categories and emits a Markdown report plus JSON sidecar at .orchestrator/metrics/repo-audit-<timestamp>.json. <example>Context: User is in a project repo and wants a baseline compliance check. user: \"/repo-audit\" assistant: \"Running repo-audit across 9 categories — Configuration, Code Quality, Git Hygiene, CI/CD, Testing, Security, Documentation, Clank Integration (optional), and MCP Configuration. Will produce a Markdown checklist report and JSON sidecar.\" <commentary>The user wants a compliance check; this skill is appropriate because it runs all 9 categories with pass/fail/warn/skipped statuses and writes structured output.</commentary></example>"
 ---
 
 # /repo-audit
 
-Use the Session Orchestrator command definition at `commands/repo-audit.md`.
+Use the Session Orchestrator skill definition at `skills/repo-audit/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/spinout.md

@@ -1,14 +1,14 @@
 ---
-description: "Guided 5-step venture-spinout / sanitized-fork runbook (copy + fresh-init + SNAPSHOT-FREEZE) — interactive, not scripted"
+description: "Use when extracting a project into its own repo — a venture spinout (e.g. a product leaving its incubator repo) or a sanitized content-snapshot fork. Guided 5-step runbook: target sphere + path, confidentiality/sanitize check, copy + fresh git init, SNAPSHOT-FREEZE marker in the source repo, remotes + registration. Trigger on 'spin out X', 'extract this into its own repo', 'fork X sanitized'."
 argument-hint: "[--type venture|snapshot] [--dry-run]"
 ---
 
 # /spinout
 
-Use the Session Orchestrator command definition at `commands/spinout.md`.
+Use the Session Orchestrator skill definition at `skills/spinout/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/sunset-review.md

@@ -1,14 +1,14 @@
 ---
-description: "Identify unused / near-zero-use / stale skills, agents, and commands as Demote or Retire candidates (read-only; never deletes)"
+description: "Use this skill when the user wants to identify unused, near-zero-use, or stale skills/agents/commands in the plugin surface so they can be demoted or retired. Combines agent-dispatch telemetry (start-events only) with static reference scanning, classifies every surface item into Active / Investigate / Demote / Retire, and emits a Markdown report plus JSON sidecar. NEVER auto-deletes — surfaces candidates for human decision. Quarterly cadence. <example>Context: The plugin surface has grown and the maintainer wants to prune dead weight. user: \"/sunset-review\" assistant: \"Running the sunset walk — classifying skills, agents, and commands by usage telemetry + static refs, grouped by Retire / Demote / Investigate / Active. No item is deleted automatically; I'll surface Retire/Demote candidates for your decision.\" <commentary>The user wants a usage-driven prune candidate list; this skill runs the read-only walker, presents grouped verdicts, and writes a sidecar — it never deletes.</commentary></example>"
 argument-hint: "[--kind skill|agent|command] [--window-days N]"
 ---
 
 # /sunset-review
 
-Use the Session Orchestrator command definition at `commands/sunset-review.md`.
+Use the Session Orchestrator skill definition at `skills/sunset-review/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/test.md

@@ -5,10 +5,10 @@ argument-hint: "[scope|profile-name] [--since <git-ref>] [--full]"
 
 # /test
 
-Use the Session Orchestrator command definition at `commands/test.md`.
+Use the Session Orchestrator skill definition at `skills/test/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/ux-grill.md

@@ -1,14 +1,14 @@
 ---
-description: "Grill a running web app's UX — a deterministic mechanical pass (axe, target size, overflow, journeys) followed by a screenshot-grounded interrogation of the operator."
+description: "Use when a running web app's UX has to be audited reproducibly rather than by feel — a deterministic mechanical pass over routes and viewports (axe, target size, horizontal overflow, page title, scripted journeys) followed by a screenshot-grounded interrogation of the operator, journey by journey, with two persona lenses from the target repo's manifest. Triggered by \"grill the UX\", \"roast the dashboard\", \"UX-Audit\", \"/ux-grill\". Bootstraps its own manifest from a loopback URL on the first run, so it never requires a hand-written file to start."
 argument-hint: "[url | manifest-path]"
 ---
 
 # /ux-grill
 
-Use the Session Orchestrator command definition at `commands/ux-grill.md`.
+Use the Session Orchestrator skill definition at `skills/ux-grill/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/rules/010-session-workflow.mdc

@@ -9,8 +9,8 @@ alwaysApply: false
 This rule is an index, not the procedure. Canonical skills:
 
 - `/session` → Read `commands/session.md`, then `skills/session-start/SKILL.md`
-- `/go` → Read `commands/go.md`, then `skills/wave-executor/SKILL.md`
-- `/close` → Read `commands/close.md`, then `skills/session-end/SKILL.md`
+- `/go` → Read `skills/go/SKILL.md`, then `skills/wave-executor/SKILL.md`
+- `/close` → Read `skills/close/SKILL.md`, then `skills/session-end/SKILL.md`
 
 Cursor has no Skill tool. Follow those files exactly. The summary below is not a substitute.
 

package/.cursor/skills/bootstrap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: bootstrap
 description: "Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked automatically by the Bootstrap Gate when CLAUDE.md, Session Config, or bootstrap.lock is missing. Also available as /bootstrap for manual invocation. Three intensity tiers: fast (demos/spikes), standard (MVPs), deep (production/team)."
+disable-model-invocation: true
 ---
 
 # bootstrap

package/.cursor/skills/close/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: close
+description: End session with verification, commits, and documentation
+disable-model-invocation: true
+---
+
+# close
+
+Canonical skill: `skills/close/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/close/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the close skill" as: Read `skills/close/SKILL.md`.

package/.cursor/skills/debug/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: debug
 description: "Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging process before proposing any fix. Iron Law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference."
-disable-model-invocation: true
 ---
 
 # debug

package/.cursor/skills/discovery/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: discovery
 description: "Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the project's tech stack, presents findings interactively for user triage, and creates VCS issues for confirmed problems. Invoked standalone via /discovery or embedded in session-end."
-disable-model-invocation: true
 ---
 
 # discovery

package/.cursor/skills/dispatcher/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: dispatcher
 description: "Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates candidate repos below the confinement root, resolves free/busy from each repo's session.lock lease, ranks the FREE ones by backlog priority × staleness × readiness, recommends the single most worthwhile one via AskUserQuestion, atomically claims it, and routes you to the chosen entry command. Triggers: \"what should I work on next\", \"dispatch me to a repo\", \"pick the next project\", \"run /dispatcher\". <example>Context: operator finished a session and wants the next-best repo across the portfolio. user: \"/dispatcher\" assistant: \"Ranked 18 free repos — top recommendation: Pencil-Designs (score 4.50, 90d stale). Confirm via the picker, I'll claim its lease atomically, then route you to /session deep.\"</example>"
-disable-model-invocation: true
 ---
 
 # dispatcher

package/.cursor/skills/eli5/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: eli5
 description: "Explain a topic like I'm a 5 year old — restate my last output, or a named topic, in plain words without dropping a single fact. Use when the user types /eli5 [topic], or says an answer was too technical, too long, or unclear about what he now has to do."
-disable-model-invocation: true
 ---
 
 # eli5

package/.cursor/skills/evolve/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: evolve
 description: "Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session history), review (edit/manage existing learnings), list (display active learnings). Manages .orchestrator/metrics/learnings.jsonl."
-disable-model-invocation: true
 ---
 
 # evolve

package/.cursor/skills/go/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: go
+description: Approve session plan and begin wave execution
+disable-model-invocation: true
+---
+
+# go
+
+Canonical skill: `skills/go/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/go/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the go skill" as: Read `skills/go/SKILL.md`.

package/.cursor/skills/grill/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: grill
 description: "Use when the user wants a plan, design, or PRD stress-tested before any build — relentlessly interrogates one decision at a time, grounds every question in the codebase, hunts contradictions against the domain language and the code, and challenges the load-bearing assumptions. Triggered by \"grill me\", \"stress-test this plan\", \"poke holes in my design\". Composable — run standalone or as an adversarial pass before /plan feature."
-disable-model-invocation: true
 ---
 
 # grill

package/.cursor/skills/harness-audit/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: harness-audit
+description: Run the harness audit and report the rubric score for this repository
+---
+
+# harness-audit
+
+Canonical skill: `skills/harness-audit/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/harness-audit/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the harness-audit skill" as: Read `skills/harness-audit/SKILL.md`.

package/.cursor/skills/portfolio/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: portfolio
+description: Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard
+---
+
+# portfolio
+
+Canonical skill: `skills/portfolio/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/portfolio/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the portfolio skill" as: Read `skills/portfolio/SKILL.md`.

package/.cursor/skills/release/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: release
+description: "Cut a release — the order the steps must run in, and the criteria that abort a release"
+disable-model-invocation: true
+---
+
+# release
+
+Canonical skill: `skills/release/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/release/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the release skill" as: Read `skills/release/SKILL.md`.

package/.cursor/skills/repo-audit/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: repo-audit
 description: "Use this skill when the user wants to audit a repository for baseline compliance, check code quality, security posture, CI/CD setup, testing, documentation, and ecosystem configuration. Runs 9 checklist categories and emits a Markdown report plus JSON sidecar at .orchestrator/metrics/repo-audit-<timestamp>.json. <example>Context: User is in a project repo and wants a baseline compliance check. user: \"/repo-audit\" assistant: \"Running repo-audit across 9 categories — Configuration, Code Quality, Git Hygiene, CI/CD, Testing, Security, Documentation, Clank Integration (optional), and MCP Configuration. Will produce a Markdown checklist report and JSON sidecar.\" <commentary>The user wants a compliance check; this skill is appropriate because it runs all 9 categories with pass/fail/warn/skipped statuses and writes structured output.</commentary></example>"
-disable-model-invocation: true
 ---
 
 # repo-audit

package/.cursor/skills/sunset-review/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: sunset-review
 description: "Use this skill when the user wants to identify unused, near-zero-use, or stale skills/agents/commands in the plugin surface so they can be demoted or retired. Combines agent-dispatch telemetry (start-events only) with static reference scanning, classifies every surface item into Active / Investigate / Demote / Retire, and emits a Markdown report plus JSON sidecar. NEVER auto-deletes — surfaces candidates for human decision. Quarterly cadence. <example>Context: The plugin surface has grown and the maintainer wants to prune dead weight. user: \"/sunset-review\" assistant: \"Running the sunset walk — classifying skills, agents, and commands by usage telemetry + static refs, grouped by Retire / Demote / Investigate / Active. No item is deleted automatically; I'll surface Retire/Demote candidates for your decision.\" <commentary>The user wants a usage-driven prune candidate list; this skill runs the read-only walker, presents grouped verdicts, and writes a sidecar — it never deletes.</commentary></example>"
-disable-model-invocation: true
 ---
 
 # sunset-review

package/.cursor/skills/test/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: test
+description: "Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues"
+---
+
+# test
+
+Canonical skill: `skills/test/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/test/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the test skill" as: Read `skills/test/SKILL.md`.