session-orchestrator 5.1.0 → 5.3.0

package/.agents/skills/mode-selector/SKILL.md

@@ -9,9 +9,11 @@ metadata:
 
 # mode-selector
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/npm-publish/SKILL.md

@@ -2,15 +2,17 @@
 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"
+  user-invocable: "false"
   model: sonnet
 ---
 
 # npm-publish
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/peekaboo-driver/SKILL.md

@@ -10,9 +10,11 @@ metadata:
 
 # peekaboo-driver
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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

@@ -3,15 +3,20 @@ 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
 ---
 
 # persona-panel
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/persona-panel/agents/openai.yaml

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

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
@@ -12,9 +14,13 @@ metadata:
 
 # plan
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/plan/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-agents-skills.mjs; do not edit.
+interface:
+  display_name: plan
+policy:
+  allow_implicit_invocation: false

package/.agents/skills/playwright-driver/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # playwright-driver
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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

@@ -0,0 +1,21 @@
+---
+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 workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/portfolio/agents/openai.yaml

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

package/.agents/skills/quality-gates/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # quality-gates
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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
@@ -13,9 +14,13 @@ metadata:
 
 # reconcile
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/reconcile/agents/openai.yaml

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

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

@@ -0,0 +1,22 @@
+---
+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 workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/release/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-agents-skills.mjs; do not edit.
+interface:
+  display_name: release
+policy:
+  allow_implicit_invocation: false

package/.agents/skills/remote-offload/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # remote-offload
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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

@@ -2,15 +2,20 @@
 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
 ---
 
 # repo-audit
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/repo-audit/SKILL.md`](../../../skills/repo-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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/repo-audit/agents/openai.yaml

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

package/.agents/skills/session/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: session
+description: Start a development session (housekeeping, feature, deep; ultradeep = deep + profile)
+metadata:
+  argument-hint: "[housekeeping|feature|deep|ultradeep] [task context]"
+---
+
+# session
+
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
+> [`commands/session.md`](../../../commands/session.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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command 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.

package/.agents/skills/session/agents/openai.yaml

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

package/.agents/skills/session-end/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # session-end
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/session-end/SKILL.md`](../../../skills/session-end/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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

@@ -12,9 +12,11 @@ metadata:
 
 # session-plan
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/session-plan/SKILL.md`](../../../skills/session-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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/session-start/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # session-start
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/session-start/SKILL.md`](../../../skills/session-start/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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

@@ -3,14 +3,19 @@ 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
 ---
 
 # spinout
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/spinout/SKILL.md`](../../../skills/spinout/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/spinout/agents/openai.yaml

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

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

@@ -2,15 +2,21 @@
 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
 ---
 
 # sunset-review
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/sunset-review/SKILL.md`](../../../skills/sunset-review/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/sunset-review/agents/openai.yaml

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

package/.agents/skills/templates-ack/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: templates-ack
+description: Acknowledge templates-first policy for the current session — bypasses the pre-bash-templates-first hook for the remainder of the session
+metadata:
+  argument-hint: "[optional-reason]"
+---
+
+# templates-ack
+
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
+> [`commands/templates-ack.md`](../../../commands/templates-ack.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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command 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.

package/.agents/skills/templates-ack/agents/openai.yaml

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

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

@@ -0,0 +1,21 @@
+---
+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 workflow 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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/test/agents/openai.yaml

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

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

@@ -12,9 +12,11 @@ metadata:
 
 # test-runner
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/test-runner/SKILL.md`](../../../skills/test-runner/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/tmux-layout/SKILL.md

@@ -13,9 +13,11 @@ allowed-tools:
 
 # tmux-layout
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/tmux-layout/SKILL.md`](../../../skills/tmux-layout/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/using-orchestrator/SKILL.md

@@ -9,9 +9,11 @@ metadata:
 
 # using-orchestrator
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/using-orchestrator/SKILL.md`](../../../skills/using-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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

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:
@@ -14,9 +16,13 @@ allowed-tools:
 
 # ux-grill
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/ux-grill/SKILL.md`](../../../skills/ux-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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in 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. Pass command arguments through structured tool parameters or safely quoted individual arguments.

package/.agents/skills/ux-grill/agents/openai.yaml

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

package/.agents/skills/vault-mirror/SKILL.md

@@ -7,9 +7,11 @@ metadata:
 
 # vault-mirror
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/vault-mirror/SKILL.md`](../../../skills/vault-mirror/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/vault-sync/SKILL.md

@@ -7,9 +7,11 @@ metadata:
 
 # vault-sync
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/vault-sync/SKILL.md`](../../../skills/vault-sync/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.

package/.agents/skills/wave-executor/SKILL.md

@@ -12,9 +12,11 @@ metadata:
 
 # wave-executor
 
-> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> **Portable mirror — generated, do not edit.** The canonical workflow lives at
 > [`skills/wave-executor/SKILL.md`](../../../skills/wave-executor/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`.
+
+Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its 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 and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.