# Command Reference

> **STALENESS WARNING (2026-04-25):** This document predates the June 1 refactor and is missing post-CP-1/CP-2 commands. Likely-missing skills include `/generate-video`, `/workspace`, `/engine`, `/dispatch`, `/pause`, `/unpause`, `/handoff`. Confirm current canonical command set against `~/.claude/skills/` before relying on this file. Cross-reference: `audit-2026-04-25/docs-freshness.md` (entry 5). Scheduled rewrite: post-CP-2 verification (~2026-06-08).

Full command-to-skill-file mapping for the Recoil Narrative Engine.

## Narrative Commands

| Phase | Command | Skill File | Agent Protocol |
|-------|---------|------------|----------------|
| **Context** | `/load-context [project] [mode]` | `.claude/skills/load-context/SKILL.md` | — |
| **Develop** | `/develop [project]` | `.claude/skills/develop/SKILL.md` | `/agents/develop_agent.md` |
| **Showrunner** | `/showrunner [project]` | `.claude/skills/showrunner/SKILL.md` | `/agents/showrunner_agent.md` |
| **Validate** | `/validate [project]` | `.claude/skills/validate/SKILL.md` | `/agents/validate_agent.md` |
| **Promote** | `/promote [project]` | `.claude/skills/promote/SKILL.md` | `/agents/promote_agent.md` |
| **Treatment** | `/treatment [project]` | `.claude/skills/treatment/SKILL.md` | `/agents/treatment_agent.md` |
| **Dramatic QC** | `/dramatic-qc [project] --mode [pre\|post\|assess]` | `.claude/skills/dramatic-qc/SKILL.md` | `/agents/dramatic_qc_agent.md` |
| **Generate Script** | `/generate-script [project]` | `.claude/skills/generate-script/SKILL.md` | Clean context per batch (pauses for /compact) |
| **Generate Script Orchestrated** | `/generate-script-orchestrated [project]` | `.claude/skills/generate-script-orchestrated/SKILL.md` | `/agents/orchestrator_agent.md` |
| **Autogenerate Scripts** | `/autogenerate-scripts [project]` | `.claude/skills/autogenerate-scripts/SKILL.md` | Fully autonomous (auto-reloads, never stops) |
| **Assess** | `/assess [project] --lens [lens]` | `.claude/skills/assess/SKILL.md` | `/agents/assess_agent.md` |
| **Rewrite** | `/rewrite [project] ep [N] "[issue]"` | `.claude/skills/rewrite/SKILL.md` | `/agents/rewrite_agent.md` |
| **Revise** | `/revise [project]` | `.claude/skills/revise/SKILL.md` | `/agents/revision_agent.md` |
| **Thread** | `/thread [project] "[name]" --episodes [N,N,N]` | `.claude/skills/thread/SKILL.md` | `/agents/thread_agent.md` |
| **Script Doctor** | `/script-doctor [project] [--to-annotations\|--deep-fix F00N\|--verify]` | `.claude/skills/script-doctor/SKILL.md` | `/agents/script_doctor_agent.md` |
| **Finish** | `/finish [project] [--from step\|--skip-doctor]` | `.claude/skills/finish/SKILL.md` | Autonomous post-gen pipeline (doctor → revise → verify → compile) |
| **Compile** | `/compile [project]` | `.claude/skills/compile/SKILL.md` | `/tools/compile_episodes.py` |
| **Camera Test** | `/camera-test [project] [ep N\|ep N-M\|--review]` | `.claude/skills/camera-test/SKILL.md` | Inline |
| **Listen** | `/listen [project] [episodes N-M\|init\|budget\|voices\|cast]` | `.claude/skills/listen/SKILL.md` | `/tools/fountain_reader.py` |
| **Novella** | `/novella [project] ep [N-M]` | `.claude/skills/novella/SKILL.md` | Inline prose conversion |

## Superseded Commands

| Command | Replacement |
|---------|-------------|
| `/breakdown [project]` | Starsend Global Bible (Stage 1) |
| `/visual-design [project]` | Starsend Casting + Location Refs |
| `/storyboard [project]` | Starsend Plan Pass (Stage 2) + Previz |

## Engine & Docs Commands

| Command | Skill File | Purpose |
|---------|------------|---------|
| `/engine-check [--quick\|--full\|--fix]` | `.claude/skills/engine-check/SKILL.md` | 53-check engine audit |
| `/validate-docs` | `.claude/skills/validate-docs/SKILL.md` | Doc consistency check |
| `/update-guides [--full]` | `.claude/skills/update-guides/SKILL.md` | Sync all docs |
| `/imagine [description]` | `.claude/skills/imagine/SKILL.md` | ComfyUI Flux 2 Klein |
| `/golden-record [image]` | `.claude/skills/golden-record/SKILL.md` | Save ComfyUI params |

## Sub-Agents (not called directly)

Spawned by `/develop` and `/showrunner`: `character_agent.md`, `plot_agent.md`, `world_agent.md`

Internal skill (used by `/generate-script-orchestrated`): `/batch`

## Assessment Lenses

For `/assess` and `/dramatic-qc`: `behavioral_dna`, `voice`, `texture`, `relationship_earning`, `visual_richness`, `continuity`, `double_view_continuity`

## Skills Reference

| Skill | Location | Purpose |
|-------|----------|---------|
| **Format Rules** | `/skills/format_v12/SKILL.md` | Word counts, dialogue %, Kill Box |
| **Dramatic Elements** | `/skills/dramatic_elements/SKILL.md` | Hooks, cliffhangers, pattern interrupts |
| **Treatment** | `/skills/treatment/SKILL.md` | Prose treatment, THE MOMENT, threads |
| **Relationship Earning** | `/skills/relationship_earning/SKILL.md` | When declarations are earned |
| **Generation Process** | `/skills/orchestration_process/SKILL.md` | How to run generation |
| **Calibration** | `/skills/calibration/SKILL.md` | GOOD/BAD examples |