Skip to content
cccskills
FreePublished on GitHub

codex-slides-known-errors

Diagnose and recover from Codex Slides plugin, MCP, Browser handoff, local runtime, durable run, project resume, rendering, Design Files, export, and version-contract failures. Use when a tool fails, a run stalls, a project appears stale, or Codex and the Browser disagree.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides
See how to install

Files included (2)

  • SKILL.md2.8 KB
  • agents/openai.yaml280 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Codex Slides Known Errors

Classify the failure before retrying. Preserve the same project id and run id; do not recreate a deck merely because a Browser tab closed or a wait timed out.

Runtime and installation

  • Plugin version contract fails: .codex-plugin/plugin.json must start with the exact root package.json version plus +codex.. The desktop package must use the same product version.
  • App is unreachable: inspect CODEX_SLIDES_URL and CODEX_SLIDES_LOG. The local MCP launcher may need to prepare dependencies or a standalone build.
  • Installed skill or tool inventory looks stale: reinstall/upgrade the plugin and start a new Codex task so the versioned plugin cache is refreshed.

Durable runs

  • Another run is active: inspect it with get_project_run. Wait, cancel it explicitly, or allow a Deck Agent request to remain in the visible queue.
  • Wait timed out: the run was not cancelled. Continue with wait_project_run or reopen its browserHandoff.
  • Run id is missing after completion: this indicates an old runtime without terminal runHistory; refresh the plugin/runtime before retrying the task.
  • Run is stopping: do not start a conflicting render. Poll until it becomes cancelled, then continue.

Browser handoff and project resume

  • Use the exact returned browserHandoff.url; do not reconstruct a project URL.
  • Keep all focus parameters: slide, panel, version, mode, checkpoint, conversation, and run.
  • A clarify/research project may route through /?resume=<id>. The continuation query must survive that redirect.
  • Presenter mode needs a user gesture for its second window. A presenter deep link opens the Play menu at the correct slide instead of bypassing popup protection.

Rendering and project state

  • A partially rendered or paused deck is resumable. Read the project and start a durable render run for the existing project.
  • If Codex state and Browser state differ, read /runs/get_project as the canonical snapshot, then reload the same Browser handoff.
  • Do not report success for slides whose status is error or whose persisted image cannot be loaded.

Design Files and export

  • Resolve Design Files through list_design_files; never guess an absolute path.
  • Keep project files distinct from staged materials.
  • Export the current or explicitly selected immutable version only after visual verification. Speaker notes are off-canvas but must remain present in PPTX.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

codex-slides

Free

Create, research, revise, restyle, present, inspect, and export Codex Slides slide decks from Codex, including scenario workflows, project Design Files, and always-on brand design systems. Use when the user asks for a presentation, PPT/PPTX, slide deck, research brief converted into slides, an existing deck edit, a marked-up slide revision, brand/style controls, project files, or to open and operate Codex Slides in the Codex in-editor Browser.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

codex-slides-browser

Free

Compatibility entry point for opening and operating Codex Slides in Codex's in-editor Browser, including scenario selection, Design Files, brand systems, decks, and Play mode. Use when the user asks to open, launch, preview, view, play, inspect, or directly manipulate Codex Slides or a deck without leaving Codex.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

codex-slides-deck

Free

Compatibility entry point for scenario-led creation, Design Files, brand systems, inspecting, revising, restyling, and exporting Codex Slides slide decks. Use when a user asks Codex to make a presentation, use project files, edit an existing deck, manage slide structure, apply brand or template rules, or export PDF/PPTX.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

codex-slides-research

Free

Compatibility entry point for researching a current topic into a source-backed Markdown brief and turning it into a Codex Slides outline or rendered deck. Use for market, competitive, policy, technical, academic, or other presentation requests that need current facts, figures, comparisons, or citations.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

codex-slides-structured-intake

Free

Collect and persist structured presentation requirements for Codex Slides, including scenario choice, audience, page count, language, format, research mode, visual direction, source-file roles, and clarification checkpoints. Use when a new deck request is ambiguous or scenario-led.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

codex-slides-verification

Free

Verify that Codex Slides changes are durably reflected in project state and visibly reflected in the exact Codex Browser slide, panel, version, checkpoint, or presentation surface. Use after creation, rendering, editing, restyling, mark edits, speaker-note changes, version restores, or export.

The English summary is being prepared. Showing the original description.

nexu-io/codex-slides951Updated Jul 21, 2026

See all skills by nexu-io

Report a problem with this skill