codex-slides-known-errors
/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.
- Author
- nexu-io ↗
- Repository
- codex-slides ↗
- Licence
- MIT
- Last repository change
- 21.07.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 21.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
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.
Original author description
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.
How it works
- Runtime and installation
- Durable runs
- Browser handoff and project resume
- Rendering and project state
- Design Files and export
SKILL.md preview
--- name: codex-slides-known-errors description: 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. --- # 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.
Files in this package (2)
- SKILL.md 3 KB
- agents/openai.yaml 1 KB
Versions
The database has no other skills named codex-slides-known-errors.
Database snapshot: 13.11.2026 · package version 55e524af0726 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100codex-slides
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… - 86codex-slides-browser
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… - 95slides-generator
Generate interactive presentation slides using React + Tailwind, and export to standalone single-file HTML. Triggers on keywords like "slides", "presentation", "PPT", "demo", "benchmark", or when user requests export. Uses agent-browser skill for browser verification before… - 87google-slides-export
Create properly formatted Google Slides presentations via the MCP API. Use this skill whenever you're building Google Slides decks, calling batch_update_presentation, designing slide layouts, or the google-slides-creator or google-slides-reviewer agents are running. This skill… - 82codex-handoff
交接当前工作到新 Codex 任务。 - 100auth-preflight
Verify Google Workspace MCP authentication at the start of any session that needs Google APIs (Docs, Slides, Drive). This skill prevents auth failures mid-workflow by testing credentials upfront. Use this skill automatically at session start when the task involves Google Docs,…