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.
Profile →npx skills add nexu-io/codex-slides --skill codex-slides-known-errors --agent codex
Same command for any agent — swap --agent for claude-code, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 conflict
- Runtime and installation
- Durable runs
- Browser handoff and project resume
- Rendering and project state
- Design Files and export
What does the codex-slides-known-errors skill do?
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 do I install it?
Run `npx skills add nexu-io/codex-slides --skill codex-slides-known-errors --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From nexu-io/codex-slides, a repository with 753 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.