Diagnose and recover from Codex Slides plugin, MCP, Browser handoff, local runtime, durable run, project resume, rendering, Design Files, export, and version-contract failures.
SkillScore95Maintained
Automatic
◆DevOps & SRE pack
Last verified 8/16/2026
What it changes
Passed 21 of 22 test cases with the skill, and 8 of 22 without it.
Without skill36%
With skill95%
Checks it passed that the model alone missed
Directs upgrading the plugin.
Directs inspecting CODEX_SLIDES_URL.
Directs inspecting CODEX_SLIDES_LOG.
and 20 more in the full report
13 fixed8 passed either way1 still failing0 broke
Pass-rate lift
+59 pp
Tokens
-25%
Agent turns
0%
Response time
-59%
Model gemini-3.6-flashMeasured 8/16/2026v121 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 13 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 13
Prompt
A clarify presentation task in Codex Slides redirects through /?resume=<id>. Our client script appends the prompt query before the redirect happens. What requirement exists for the continuation query during this flow?
What was checked, without and with the skill
Checked
Without skill
With skill
Specifies that the continuation query must survive the resume redirect.
Missed
Passed
case-09 · gemini-3.6-flash · 8/16/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md52 linessingle file
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