codex-slides-deck

# Codex Slides Deck

The canonical `codex-slides` sibling skill owns the complete workflow. Use the
`codex_slides` MCP tools when available; otherwise run its self-contained CLI
at `../codex-slides/scripts/codex-slides.mjs`. Keep the live workspace available
in the in-editor Browser whenever visual review helps.

## Choose the flow

- Default to the live Browser workflow: open the Codex Slides home screen,
  submit the request there, then operate the created project through clarify,
  outline confirmation, style selection, rendering, and review. Keep the
  Browser visible throughout.
- If Browser UI submission fails, use `start_project` / CLI `start-project` to
  create the durable project shell, immediately open its returned URL, and
  continue in the UI.

- Use `list_scenarios` / CLI `scenarios` when a named workflow such as business
  report, document-to-deck, data insights, brand application, localization, or
  batch generation fits. Upload required slot files and pass `scenarioId`,
  `materialIds`, and `materialContexts` into creation.
- Only when the user explicitly requests an unattended/headless one-call
  result, call `create_deck` or CLI command `create`.
- For CLI automation or recovery, call `create_outline`, optionally
  `revise_outline` and `rank_inspiration`, then `render_deck`; the CLI commands
  are `outline`, `revise-outline`, `inspiration`, and `render`.
- For an existing deck, use `list_projects` or `get_project`, then choose the
  smallest mutation tool.

## Edit with the right tool

- Use `edit_deck` for natural-language add/rewrite/redraw/optimize requests.
- Use `manage_slide` for deterministic add, duplicate, delete, or transition.
- Use `regenerate_slide` for one slide.
- Use `restyle_deck` for a whole-deck template/style change.
- Use `upload_material` before creation, editing, or restyling when a local
  reference file matters.
- Use `upload_slide_image` for a finished PNG.
- Use `mark_edit_slide` when the user supplies an annotated PNG and wants a
  clean revised slide.
- Use `get_speaker_notes`, `update_speaker_notes`, and
  `generate_speaker_notes` (CLI `speaker-notes` with `get`, `set`, or
  `generate`) for presenter-only talk tracks. These notes persist per slide,
  appear in the speaker window, and are embedded in PPTX export.
- Use `list_design_files`, `read_design_file`, `write_design_file`, and
  `upload_design_file` for the project file workspace. Pass selected paths as
  `designFilePaths` when revising an outline or editing a deck.
- Use `get_brand_design_system` then `update_brand_design_system` for persistent
  project-wide brand/style rules. Redraw only when requested.
- Use `start_project_run` for navigation-independent chat, outline, or render
  work; retain the returned `runId` and track or cancel it explicitly.

## Show and verify

Open `open_codex_slides` / CLI `open` before a new creation and keep the live
workspace visible. After a programmatic mutation, navigate or reload its
resource link and inspect the changed slide or flow; do not make the user open
the URL manually.

Follow the exact `browserHandoff.url`; it can focus the changed slide, speaker
notes, export, versions, Design Files, brand system, Play menu, or durable run.

Use `export_deck` only after the requested visual result is ready. Browser-only
controls such as Play from current/beginning, the synchronized audience and
presenter windows, notes editing, slide navigation, and direct on-canvas marking
remain available through the live workspace.