session-orchestrator 3.24.0 → 4.0.0

package/.agents/skills/architecture/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: architecture
+description: Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable. Surfaces shallow modules and hypothetical seams using a precise vocabulary (Module / Interface / Implementation / Depth / Seam / Adapter / Leverage / Locality from LANGUAGE.md).
+license: MIT
+metadata:
+  model: inherit
+  derived-from: mattpocock/skills@90ea8ee
+  upstream-url: https://github.com/mattpocock/skills/tree/main/improve-codebase-architecture
+---
+
+# architecture
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/architecture/SKILL.md`](../../../skills/architecture/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/autopilot/SKILL.md

@@ -0,0 +1,17 @@
+---
+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"
+  tags: phase-c, autopilot, autonomous, loop
+  model: sonnet
+---
+
+# autopilot
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/autopilot/SKILL.md`](../../../skills/autopilot/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/bootstrap/SKILL.md

@@ -0,0 +1,20 @@
+---
+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"
+  tags: bootstrap, setup, scaffold, init
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# bootstrap
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/bootstrap/SKILL.md`](../../../skills/bootstrap/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/brainstorm/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: brainstorm
+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
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+---
+
+# brainstorm
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/brainstorm/SKILL.md`](../../../skills/brainstorm/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/claude-md-drift-check/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: claude-md-drift-check
+description: "Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository state. Ten checks: absolute-path resolution, 01-projects/ count claims, issue-reference freshness, session-file existence, command-count sync, session-config-parity (mandatory template keys = error, opt-in gaps = warning), vault-dir-parity (CLAUDE.md vs AGENTS.md), generated-rule-staleness (WARN-only), rule-scoping (paths:/globs: frontmatter defects, dangling rule citations, zero-match globs), and docs-parity (docs/components.md count-claims vs on-disk counts, template-vs-reference config-key parity, stale .claude/metrics/ paths). Full per-check spec in the body table. Invoked as an opt-in session-end phase; mirrors vault-sync's lean JSON+exit-code contract."
+metadata:
+  model: haiku
+---
+
+# claude-md-drift-check
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/claude-md-drift-check/SKILL.md`](../../../skills/claude-md-drift-check/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/convergence-monitoring/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: convergence-monitoring
+description: "Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity — drive a Stop/Continue/Investigate decision at each inter-wave checkpoint. Distinct from /evolve (retrospective) and session-reviewer (wave output review): convergence-monitoring answers \"are we making progress?\" not \"was the last wave correct?\". Primary consumer: /autoresearch loops and wave-executor inter-wave checkpoints."
+metadata:
+  user-invocable: "true"
+  tags: autoresearch, convergence, loop-control, wave-executor
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  attribution: |
+    Inspired by cavekit's documented convergence-monitoring concept (MIT, Julius Brussee). Implemented from spec since upstream skill not yet published as of 2026-04-30.
+---
+
+# convergence-monitoring
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/convergence-monitoring/SKILL.md`](../../../skills/convergence-monitoring/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

@@ -0,0 +1,22 @@
+---
+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."
+metadata:
+  model: inherit
+  color: red
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+---
+
+# debug
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/debug/SKILL.md`](../../../skills/debug/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/discovery/SKILL.md

@@ -0,0 +1,20 @@
+---
+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"
+  tags: quality, discovery, probes, issues
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# discovery
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/discovery/SKILL.md`](../../../skills/discovery/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/dispatcher/SKILL.md

@@ -0,0 +1,15 @@
+---
+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:
+  model: sonnet
+---
+
+# dispatcher
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/dispatcher/SKILL.md`](../../../skills/dispatcher/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/docs-orchestrator/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: docs-orchestrator
+description: "Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to audience-specific docs tasks (User / Dev / Vault), dispatches the docs-writer agent with source-grounded prompts, and reports coverage gaps to session-end. Gated on `docs-orchestrator.enabled: true` in Session Config. Zero overhead when disabled."
+metadata:
+  user-invocable: "false"
+  tags: docs, orchestration, audiences
+  model: sonnet
+  model-preference: sonnet
+---
+
+# docs-orchestrator
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/docs-orchestrator/SKILL.md`](../../../skills/docs-orchestrator/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/ecosystem-health/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: ecosystem-health
+description: Monitor health across configured service endpoints, CI pipelines, and critical issues. Automatically invoked during session-start when ecosystem-health is enabled in Session Config.
+metadata:
+  user-invocable: "false"
+  tags: reference, health, monitoring, ci, endpoints
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# ecosystem-health
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/ecosystem-health/SKILL.md`](../../../skills/ecosystem-health/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/eli5/SKILL.md

@@ -0,0 +1,20 @@
+---
+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:
+  model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+---
+
+# eli5
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/eli5/SKILL.md`](../../../skills/eli5/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/eval/SKILL.md

@@ -0,0 +1,21 @@
+---
+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"
+  tags: eval, measurement, quality, meta, standard
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  args-schema: "[{\"flag\":\"--session\",\"description\":\"session_id to evaluate (default: last completed session via the resolution cascade)\"},{\"flag\":\"--no-write\",\"description\":\"Evaluate + report without appending to the eval journal (.orchestrator/metrics/eval.jsonl)\"},{\"flag\":\"--verify\",\"description\":\"Re-evaluate a stored run-id and diff per-dimension for scoring drift (exit 1 on drift)\"}]"
+---
+
+# eval
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/eval/SKILL.md`](../../../skills/eval/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/evolve/SKILL.md

@@ -0,0 +1,21 @@
+---
+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"
+  tags: learning, intelligence, meta
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  args-schema: "[{\"flag\":\"--apply\",\"description\":\"Apply dialectic-derived diff to USER.md + AGENT.md\"},{\"flag\":\"--dry-run\",\"description\":\"Show diff without writing (default)\"},{\"flag\":\"--model <name>\",\"description\":\"Override single-pass LLM (haiku|sonnet|opus)\"},{\"flag\":\"--budget-tokens <N>\",\"description\":\"Token budget for derivation prompt (default 8000)\"}]"
+---
+
+# evolve
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/evolve/SKILL.md`](../../../skills/evolve/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/frontmatter-guard/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: frontmatter-guard
+description: "Injects the canonical vault frontmatter schema snippet into agent prompts before any vault-write task, preventing malformed YAML frontmatter in Obsidian notes. <example>Context: wave-executor is about to dispatch a vault-mirror agent that writes learning notes under ~/Projects/vault/40-learnings/. user: \"dispatch vault-write agent\" assistant: \"Injecting frontmatter-guard snippet into agent prompt (vault scope detected). Required fields: id, type, created, updated. Enum type: note|daily|project|person|reference|idea|learning|session.\" <commentary>The wave-executor pre-dispatch hook calls detectVaultTaskScope() — the fileScope contains /Projects/vault/40-learnings/ so the guard triggers and the snippet is prepended to the agent system prompt.</commentary></example>"
+metadata:
+  model: inherit
+---
+
+# frontmatter-guard
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/frontmatter-guard/SKILL.md`](../../../skills/frontmatter-guard/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/gitlab-ops/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: gitlab-ops
+description: "Use this skill when performing VCS operations on GitLab or GitHub repositories — creating, updating, or closing issues and MRs, applying label taxonomy, running `glab`/`gh` CLI commands, or resolving project paths dynamically. Acts as the single source of truth for CLI command syntax and label conventions; consuming skills reference this rather than duplicating logic. Triggers: \"create a GitLab issue\", \"list open MRs\", \"apply priority label\", \"how do I resolve the project ID\", \"what's the carryover issue template\". <example>Context: session-end needs to file a carryover issue for an incomplete task. user: \"/close\" assistant: \"Creating carryover issue via glab with the Carryover Template from gitlab-ops — labels: carryover, priority::high.\"</example>"
+metadata:
+  user-invocable: "false"
+  tags: reference, vcs, gitlab, github, issues
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# gitlab-ops
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/gitlab-ops/SKILL.md`](../../../skills/gitlab-ops/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/gitlab-portfolio/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: gitlab-portfolio
+description: "Use when you need a single-pane cross-repo health view across all vault-registered GitLab and GitHub projects. Discovers repos from `_overview.md` frontmatter in `<vault>/01-projects/*/`, aggregates open issues, MRs, critical labels, and stale signals via parallel `glab`/`gh` calls, then writes an idempotent `_PORTFOLIO.md` dashboard. Runs automatically at session-start Phase 2 when `gitlab-portfolio.enabled=true`. Triggers: \"show portfolio status\", \"refresh the portfolio dashboard\", \"which repos have critical issues\", \"run /portfolio\". <example>Context: session-start, gitlab-portfolio.enabled=true, vault has 5 registered repos. user: \"/session deep\" assistant: \"Portfolio: 3 critical issues across 2 repos — run /portfolio for details. Dashboard written to vault/01-projects/_PORTFOLIO.md.\"</example>"
+metadata:
+  model: sonnet
+---
+
+# gitlab-portfolio
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/gitlab-portfolio/SKILL.md`](../../../skills/gitlab-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/grill/SKILL.md

@@ -0,0 +1,22 @@
+---
+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:
+  model: inherit
+  color: red
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+---
+
+# grill
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/grill/SKILL.md`](../../../skills/grill/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/hook-development/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: hook-development
+description: Use when creating, modifying, or debugging Claude Code hooks — PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification. Covers the plugin `hooks/hooks.json` wrapper format vs. the user `settings.json` direct format, matchers, security patterns, `$CLAUDE_PLUGIN_ROOT` portability, lifecycle limitations, and debugging. Trigger on "add a hook", "validate tool use", "block dangerous commands", "enforce completion", "hook-based automation".
+metadata:
+  model: sonnet
+---
+
+# hook-development
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/hook-development/SKILL.md`](../../../skills/hook-development/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/mcp-builder/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: mcp-builder
+description: Use when creating a new MCP (Model Context Protocol) server, extending an existing one, or debugging tool discoverability/performance. Guides through research → implementation → test → eval phases with TypeScript-first guidance matching our stack. Trigger on phrases like "build an MCP server", "expose X as an MCP tool", "write MCP tools for Y", "integrate Z via MCP".
+metadata:
+  model: sonnet
+---
+
+# mcp-builder
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/mcp-builder/SKILL.md`](../../../skills/mcp-builder/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

@@ -0,0 +1,21 @@
+---
+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"
+  tags: memory, maintenance, meta, dream
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  args-schema: "[{\"flag\":\"--dry-run\",\"description\":\"Produce complete-body proposal in .orchestrator/pending-dream.md, no mutations.\"},{\"flag\":\"--apply-pending\",\"description\":\"Consume .orchestrator/pending-dream.md (atomic apply).\"}]"
+---
+
+# memory-cleanup
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/memory-cleanup/SKILL.md`](../../../skills/memory-cleanup/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/mode-selector/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: mode-selector
+description: "Use this skill when performing deterministic mode selection for session-start. Reads Phase A STATE.md recommendations + (future) learnings, sessions, backlog, bootstrap signals and returns {mode, rationale, confidence, alternatives}. Pure-function contract — no side effects, no STATE.md writes. Phase B scaffold (issue #276); full heuristic is follow-up sub-issues."
+metadata:
+  model: haiku
+  user-invocable: "false"
+  tags: phase-b, autopilot, mode-selection, scaffold
+---
+
+# mode-selector
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/mode-selector/SKILL.md`](../../../skills/mode-selector/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/npm-publish/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: npm-publish
+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".
+metadata:
+  user-invocable: "true"
+  model: sonnet
+---
+
+# npm-publish
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/npm-publish/SKILL.md`](../../../skills/npm-publish/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/peekaboo-driver/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: peekaboo-driver
+description: Use this skill when driving native-UI AX-tree snapshots and screenshots via steipete/peekaboo (MIT, macOS-only). Dispatched by `skills/test-runner/` to capture native-UI AX-tree snapshots + screenshots on macOS 15+ targets, and exits with deterministic JSON output the orchestrator can parse.
+metadata:
+  user-invocable: "false"
+  tags: test, driver, macos, peekaboo
+  model: haiku
+  model-preference: sonnet
+---
+
+# peekaboo-driver
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/peekaboo-driver/SKILL.md`](../../../skills/peekaboo-driver/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/persona-panel/SKILL.md

@@ -0,0 +1,17 @@
+---
+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"
+  tags: review, personas, content, quality, multi-agent
+  model: inherit
+---
+
+# persona-panel
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/persona-panel/SKILL.md`](../../../skills/persona-panel/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/plan/SKILL.md

@@ -0,0 +1,20 @@
+---
+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"
+  tags: planning, prd, requirements, research
+  model: inherit
+  model-preference: opus
+  model-preference-codex: gpt-5.4
+  model-preference-cursor: claude-opus-4-6
+---
+
+# plan
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/plan/SKILL.md`](../../../skills/plan/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/playwright-driver/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: playwright-driver
+description: Use this skill when executing web tests via the canonical `playwright` npm package (Microsoft, Apache-2.0). Dispatched by `skills/test-runner/` to execute web tests against a target, captures token-frugal AX-tree snapshots + screenshots + console output under `.orchestrator/metrics/test-runs/<run-id>/`, and exits with deterministic JSON output the orchestrator can parse.
+metadata:
+  user-invocable: "false"
+  tags: test, driver, web, playwright
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# playwright-driver
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/playwright-driver/SKILL.md`](../../../skills/playwright-driver/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/quality-gates/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: quality-gates
+description: Use this skill when referencing canonical quality check commands for typecheck, test, and lint. Defines 4 variants (Baseline, Incremental, Full Gate, Per-File) used by session-start, wave-executor, session-end, and session-reviewer. Reference skill — not invoked directly.
+metadata:
+  user-invocable: "false"
+  tags: reference, quality, typecheck, test, lint
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# quality-gates
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/quality-gates/SKILL.md`](../../../skills/quality-gates/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

@@ -0,0 +1,21 @@
+---
+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"
+  tags: learning, rules, intelligence, meta
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  args-schema: "[{\"flag\":\"--dry-run\",\"description\":\"Print proposals without writing anything or rendering the approval AUQ\"}]"
+---
+
+# reconcile
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/reconcile/SKILL.md`](../../../skills/reconcile/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/remote-offload/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: remote-offload
+description: Use when local resource pressure would shrink or coordinator-direct a wave, a wave plan carries heavy build/test/audit roles (test, ui, perf), or the operator says offload, remote host, or auslagern — reference for routing that wave role to a declared SSH-reachable host instead of reducing agent count
+metadata:
+  user-invocable: "false"
+  tags: reference, remote, offload, wave-executor, resource-gate
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+# remote-offload
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/remote-offload/SKILL.md`](../../../skills/remote-offload/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`.