agentsclimarketplace

Codex slides known errors

Skill nexu-io/codex-slides/skills/codex-slides-known-errors

🎨 Open-source AI slide studio inside Codex: image-native decks, every slide a full visual canvas. ⚡ 10+ high-quality slides in ~4–5 minutes — Fast mode renders every page in parallel. 🔍 Watch the whole chain live: research → outline → style → render → edit → present → export PDF/PPTX. 🖥️ Browser-first · zero API keys · durable projects.

Install
npx -y skills add nexu-io/codex-slides --skill codex-slides-known-errors

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 26 days oldThe repository was created 26 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

2.8 KB, as published. Nobody here has run it

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.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.