Skip to content
Skills Library
Documents & office · Analysis

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.

Licence
MIT
Last repository change
21.07.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.07.2026, without references to retired models or APIs.

Licence

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

  1. Runtime and installation
  2. Durable runs
  3. Browser handoff and project resume
  4. Rendering and project state
  5. Design Files and export
Original SKILL.md headings · 54 lines, 377 words
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,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.