How ningzimu/codex-ppt-skill works
Codex PPT is an agent skill that turns source material into image-based PowerPoint decks. Its documented workflow guides the user through outline, page count, style, backend, and sample approval; slide prompts/jobs are then prepared for generation, selected images are recorded, and a local assembler creates the PPTX with speaker notes. The README also documents reusable built-in/personal styles, custom reference assets, required images, concurrent slide agents, and API/CLI image fallbacks. Some workflow capabilities are documented but their implementation was not sampled, so those connections are shown at the skill boundary rather than inferred script-to-script.
Main entry points: SKILL.md PPT workflow · record_slide_result.py Record slide result · factory.py Provider selection · assemble_ppt.py PPTX assembler
Components 22
Planning and style
- PPT workflow
skills/codex-ppt/SKILL.md - Style references
skills/codex-ppt/references - Custom references
skills/codex-ppt/docs/user-supplied-assets.md - Outline and speech
skills/codex-ppt/SKILL.md
Slide generation
- Prompt preparation
skills/codex-ppt/scripts/prepare_slide_prompts.py - Slide jobs and state
skills/codex-ppt/scripts/slide_run_state.py - Slide workers
skills/codex-ppt/prompts/slide-worker.md - Image CLI
skills/codex-ppt/scripts/image_gen.py - Record slide result
skills/codex-ppt/scripts/record_slide_result.py - Run state helpers
skills/codex-ppt/scripts/slide_run_state.py - Chroma processing
skills/codex-ppt/scripts/remove_chroma_key.py
Deck assembly
- Final slide images
- PPTX assembler
skills/codex-ppt/scripts/assemble_ppt.py
Runtime and providers
- Provider selection
skills/codex-ppt/scripts/image_providers/factory.py - OpenAI-compatible
skills/codex-ppt/scripts/image_providers/openai_compatible.py - AtlasCloud
skills/codex-ppt/scripts/image_providers/atlascloud.py - Shared agent runtime
skills/codex-ppt/scripts/codex_ppt_runtime.py
Other components
- User
- Host agent
- Source material
- Image API
- PowerPoint deck
Connections 23
- User → Host agent: requests deck
- Source material → Host agent: provides content
- Host agent → PPT workflow: invokes workflow
- PPT workflow → Outline and speech: confirms outline
- PPT workflow → Style references: offers styles
- PPT workflow → Custom references: analyzes references
- PPT workflow → Prompt preparation: prepares slides
- Prompt preparation → Slide jobs and state: writes jobs
- PPT workflow → Slide workers: dispatches slides
- Slide workers → Image CLI: requests images
- Image CLI → Provider selection: selects provider
- Provider selection → OpenAI-compatible: creates provider
- Provider selection → AtlasCloud: creates provider
- OpenAI-compatible → Image API: sends generation request
- AtlasCloud → Image API: submits prediction
- PPT workflow → Record slide result: records selected output
- Record slide result → Run state helpers: updates job state
- Record slide result → Final slide images: copies selected image
- PPT workflow → Chroma processing: removes key color
- Final slide images → PPTX assembler: reads slide images
- Outline and speech → PPTX assembler: supplies speaker notes
- PPTX assembler → PowerPoint deck: writes deck
- Shared agent runtime → OpenAI-compatible: configures environment