session-orchestrator 5.1.0 → 5.2.0

package/.agents/skills/autopilot/SKILL.md

@@ -3,6 +3,7 @@ name: autopilot
 description: "Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan → wave-executor → session-end for N iterations with all 10 kill-switches (SPIRAL, FAILED wave, carryover > 50%, max-hours, max-sessions, resource-overload, token-budget, stall-timeout, sub-threshold confidence, user-abort). Reads Mode-Selector output (Phase B) to decide auto-execute vs. fallback. Writes one autopilot.jsonl record per loop run. Phase C scaffold (issue #277); implementation lives in scripts/lib/autopilot.mjs (Phase C-1 follow-up)."
 metadata:
   user-invocable: "true"
+  argument-hint: "[--headless] [--verbose] [--max-sessions=N] [--max-hours=H] [--confidence-threshold=0.X] [--dry-run]"
   tags: phase-c, autopilot, autonomous, loop
   model: sonnet
 ---

package/.agents/skills/bootstrap/SKILL.md

@@ -3,6 +3,8 @@ 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)."
 metadata:
   user-invocable: "true"
+  disable-model-invocation: "true"
+  argument-hint: "[--upgrade <tier>]"
   tags: bootstrap, setup, scaffold, init
   model: sonnet
   model-preference: sonnet

package/.agents/skills/brainstorm/SKILL.md

@@ -4,6 +4,9 @@ description: Use when you have a feature idea but the scope or UX is still ambig
 metadata:
   model: inherit
   color: cyan
+  user-invocable: "true"
+  disable-model-invocation: "true"
+  argument-hint: "[topic-or-feature-slug]"
 allowed-tools:
   - Read
   - Grep

package/.agents/skills/close/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: close
+description: End session with verification, commits, and documentation
+metadata:
+  user-invocable: "true"
+  disable-model-invocation: "true"
+  model: inherit
+---
+
+# close
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/close/SKILL.md`](../../../skills/close/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/debug/SKILL.md

@@ -4,6 +4,8 @@ description: "Use when encountering any bug, test failure, build break, or unexp
 metadata:
   model: inherit
   color: red
+  user-invocable: "true"
+  argument-hint: "[bug-description-or-issue-ref]"
 allowed-tools:
   - Read
   - Grep

package/.agents/skills/discovery/SKILL.md

@@ -2,7 +2,8 @@
 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.
 metadata:
-  user-invocable: "false"
+  user-invocable: "true"
+  argument-hint: "[all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]"
   tags: quality, discovery, probes, issues
   model: sonnet
   model-preference: sonnet

package/.agents/skills/dispatcher/SKILL.md

@@ -2,6 +2,8 @@
 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>"
 metadata:
+  user-invocable: "true"
+  argument-hint: "[--dry-run] [--repo <name>]"
   model: sonnet
 ---
 

package/.agents/skills/eli5/SKILL.md

@@ -2,6 +2,8 @@
 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.
 metadata:
+  user-invocable: "true"
+  argument-hint: "[topic]"
   model: inherit
 allowed-tools:
   - Read

package/.agents/skills/eval/SKILL.md

@@ -3,6 +3,7 @@ name: eval
 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.
 metadata:
   user-invocable: "true"
+  argument-hint: "[--session <id>] [--no-write] [--verify <run-id>]"
   tags: eval, measurement, quality, meta, standard
   model: sonnet
   model-preference: sonnet

package/.agents/skills/evolve/SKILL.md

@@ -2,7 +2,8 @@
 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."
 metadata:
-  user-invocable: "false"
+  user-invocable: "true"
+  argument-hint: "[analyze|review|list|dialectic [--apply]]"
   tags: learning, intelligence, meta
   model: sonnet
   model-preference: sonnet

package/.agents/skills/go/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: go
+description: Approve session plan and begin wave execution
+metadata:
+  user-invocable: "true"
+  disable-model-invocation: "true"
+  argument-hint: "[optional instructions]"
+  model: inherit
+---
+
+# go
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/go/SKILL.md`](../../../skills/go/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/grill/SKILL.md

@@ -2,6 +2,8 @@
 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.
 metadata:
+  user-invocable: "true"
+  argument-hint: "[file-path-or-topic]"
   model: inherit
   color: red
 allowed-tools:

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

@@ -0,0 +1,16 @@
+---
+name: harness-audit
+description: Run the harness audit and report the rubric score for this repository
+metadata:
+  user-invocable: "true"
+  model: inherit
+---
+
+# harness-audit
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/harness-audit/SKILL.md`](../../../skills/harness-audit/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/memory-cleanup/SKILL.md

@@ -3,6 +3,7 @@ name: memory-cleanup
 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.
 metadata:
   user-invocable: "true"
+  argument-hint: "[--dry-run | --apply-pending]"
   tags: memory, maintenance, meta, dream
   model: sonnet
   model-preference: sonnet

package/.agents/skills/persona-panel/SKILL.md

@@ -3,6 +3,7 @@ name: persona-panel
 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>.
 metadata:
   user-invocable: "true"
+  argument-hint: <target> [--personas <names,...>] [--mode <voting|hard-gate|summary>] [--threshold <M-of-N|all|any>] [--grounding <off|re-derive>] [--dry-run]
   tags: review, personas, content, quality, multi-agent
   model: inherit
 ---

package/.agents/skills/plan/SKILL.md

@@ -2,7 +2,9 @@
 name: plan
 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."
 metadata:
-  user-invocable: "false"
+  user-invocable: "true"
+  disable-model-invocation: "true"
+  argument-hint: "[new|feature|retro]"
   tags: planning, prd, requirements, research
   model: inherit
   model-preference: opus

package/.agents/skills/portfolio/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: portfolio
+description: Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard
+metadata:
+  user-invocable: "true"
+  argument-hint: "[--dry-run] [--repo <name>]"
+  model: inherit
+---
+
+# portfolio
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/portfolio/SKILL.md`](../../../skills/portfolio/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/reconcile/SKILL.md

@@ -3,6 +3,7 @@ name: reconcile
 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.
 metadata:
   user-invocable: "true"
+  argument-hint: "[--dry-run]"
   tags: learning, rules, intelligence, meta
   model: sonnet
   model-preference: sonnet

package/.agents/skills/release/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: release
+description: Cut a release — the order the steps must run in, and the criteria that abort a release
+metadata:
+  user-invocable: "true"
+  disable-model-invocation: "true"
+  argument-hint: "[X.Y.Z]"
+  model: inherit
+---
+
+# release
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/release/SKILL.md`](../../../skills/release/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

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

@@ -2,6 +2,7 @@
 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>"
 metadata:
+  user-invocable: "true"
   model: inherit
   color: cyan
 ---

package/.agents/skills/spinout/SKILL.md

@@ -3,6 +3,7 @@ name: spinout
 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'."
 metadata:
   user-invocable: "true"
+  argument-hint: "[--type venture|snapshot] [--dry-run]"
   model: sonnet
 ---
 

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

@@ -2,6 +2,8 @@
 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>"
 metadata:
+  user-invocable: "true"
+  argument-hint: "[--kind skill|agent|command] [--window-days N]"
   model: inherit
   color: amber
 ---

package/.agents/skills/test/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: test
+description: Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues
+metadata:
+  user-invocable: "true"
+  argument-hint: "[scope|profile-name] [--since <git-ref>] [--full]"
+  model: inherit
+---
+
+# test
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/test/SKILL.md`](../../../skills/test/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/ux-grill/SKILL.md

@@ -2,6 +2,8 @@
 name: ux-grill
 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.
 metadata:
+  user-invocable: "true"
+  argument-hint: "[url | manifest-path]"
   model: inherit
   color: magenta
 allowed-tools:

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "A repeatable Plan, Go, Close workflow for AI coding sessions: /session reads your repo and agrees the scope, /go runs the work in waves with a quality gate between each, /close verifies and commits. Runs on Claude Code, Codex CLI, Cursor and Pi.",
-    "version": "5.1.0"
+    "version": "5.2.0"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "session-orchestrator",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "A repeatable Plan, Go, Close workflow for AI coding sessions: /session reads your repo and agrees the scope, /go runs the work in waves with a quality gate between each, /close verifies and commits. Runs on Claude Code, Codex CLI, Cursor and Pi.",
   "author": {
     "name": "Bernhard Goetzendorfer",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "session-orchestrator",
-  "version": "5.1.0+codex.20260913171452",
+  "version": "5.2.0+codex.20260917190217",
   "description": "A repeatable Plan, Go, Close workflow for AI coding sessions: /session reads your repo and agrees the scope, /go runs the work in waves with a quality gate between each, /close verifies and commits. Runs on Claude Code, Codex CLI, Cursor and Pi.",
   "keywords": [
     "session",

package/.codex-plugin/skills/autopilot/SKILL.md

@@ -1,21 +1,22 @@
 ---
 name: autopilot
-description: Autonomous session-orchestration loop with kill-switches (Phase C-1.b — all 10 kill-switches shipped)
+description: 'Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan → wave-executor → session-end for N iterations with all 10 kill-switches (SPIRAL, FAILED wave, carryover > 50%, max-hours, max-sessions, resource-overload, token-budget, stall-timeout, sub-threshold confidence, user-abort). Reads Mode-Selector output (Phase B) to decide auto-execute vs. fallback. Writes one autopilot.jsonl record per loop run. Phase C scaffold (issue #277); implementation lives in scripts/lib/autopilot.mjs (Phase C-1 follow-up).'
 metadata:
+  user-invocable: 'true'
   argument-hint: '[--headless] [--verbose] [--max-sessions=N] [--max-hours=H] [--confidence-threshold=0.X] [--dry-run]'
+  tags: phase-c, autopilot, autonomous, loop
+  model: sonnet
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # autopilot
 
-Read [`commands/autopilot.md`](../../../commands/autopilot.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/autopilot/SKILL.md`](../../../skills/autopilot/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/bootstrap/SKILL.md

@@ -1,22 +1,26 @@
 ---
 name: bootstrap
-description: Scaffold the minimum repo structure required by session-orchestrator
+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).'
 metadata:
+  user-invocable: 'true'
   disable-model-invocation: 'true'
   argument-hint: '[--upgrade <tier>]'
+  tags: bootstrap, setup, scaffold, init
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # bootstrap
 
-Read [`commands/bootstrap.md`](../../../commands/bootstrap.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/bootstrap/SKILL.md`](../../../skills/bootstrap/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/brainstorm/SKILL.md

@@ -1,22 +1,29 @@
 ---
 name: brainstorm
-description: Run a lightweight Socratic design dialogue (3-5 AUQ rounds) and write a spec markdown file before any implementation work. Use BEFORE /plan feature when scope/UX is ambiguous.
+description: Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue (3-5 AUQ rounds) and writes a spec markdown file. Use BEFORE /plan feature when product intent needs validation; skip to /plan feature when scope is already clear. HARD-GATE prevents any code work until the design is user-approved.
 metadata:
+  model: inherit
+  color: cyan
+  user-invocable: 'true'
   disable-model-invocation: 'true'
   argument-hint: '[topic-or-feature-slug]'
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # brainstorm
 
-Read [`commands/brainstorm.md`](../../../commands/brainstorm.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/brainstorm/SKILL.md`](../../../skills/brainstorm/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/close/SKILL.md

@@ -2,20 +2,20 @@
 name: close
 description: End session with verification, commits, and documentation
 metadata:
+  user-invocable: 'true'
   disable-model-invocation: 'true'
+  model: inherit
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # close
 
-Read [`commands/close.md`](../../../commands/close.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/close/SKILL.md`](../../../skills/close/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/convergence-monitoring/SKILL.md

@@ -21,4 +21,6 @@ The linked document is authoritative, including its prechecks, argument rules, a
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
+`$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
+
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/convergence-monitoring/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: convergence-monitoring
+policy:
+  allow_implicit_invocation: true

package/.codex-plugin/skills/debug/SKILL.md

@@ -1,21 +1,28 @@
 ---
 name: debug
-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.'
 metadata:
+  model: inherit
+  color: red
+  user-invocable: 'true'
   argument-hint: '[bug-description-or-issue-ref]'
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # debug
 
-Read [`commands/debug.md`](../../../commands/debug.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/debug/SKILL.md`](../../../skills/debug/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/discovery/SKILL.md

@@ -1,21 +1,25 @@
 ---
 name: discovery
-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.
 metadata:
+  user-invocable: 'true'
   argument-hint: '[all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]'
+  tags: quality, discovery, probes, issues
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # discovery
 
-Read [`commands/discovery.md`](../../../commands/discovery.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/discovery/SKILL.md`](../../../skills/discovery/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/dispatcher/SKILL.md

@@ -1,21 +1,21 @@
 ---
 name: dispatcher
-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>'
 metadata:
+  user-invocable: 'true'
   argument-hint: '[--dry-run] [--repo <name>]'
+  model: sonnet
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # dispatcher
 
-Read [`commands/dispatcher.md`](../../../commands/dispatcher.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/dispatcher/SKILL.md`](../../../skills/dispatcher/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/eli5/SKILL.md

@@ -1,21 +1,26 @@
 ---
 name: eli5
-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.
 metadata:
+  user-invocable: 'true'
   argument-hint: '[topic]'
+  model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # eli5
 
-Read [`commands/eli5.md`](../../../commands/eli5.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/eli5/SKILL.md`](../../../skills/eli5/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.