ningzimu__codex-ppt-skill/docs/en

Codex PPT Skill Documentation

Codex PPT is a presentation-generation skill built for Codex. It also works with agents that support SKILL.md, including Claude Code, OpenClaw, and Hermes Agent. It turns articles, reports, papers, course notes, or rough ideas into image-based presentations: first planning the outline and visual style, then generating each complete slide as an image, and finally assembling the images into a .pptx file.

Sponsor

Thanks to Atlas Cloud for sponsoring this project. AtlasCloud is a multimodal AI inference platform that provides one API for image generation, video generation, LLMs, and more. This skill can use the existing API key, base URL, and model-name configuration to call AtlasCloud's GPT Image 2 generation and editing endpoints, with pay-as-you-go pricing and out-of-the-box setup. See the full model list on the Atlas Cloud models page.

Codia NoteSlide

Make generated slides editable. Convert slide images generated by Codex PPT, PDFs, or presentations exported from NotebookLM into editable PowerPoint files. Fast conversion, affordable pricing, and good visual fidelity make it a useful choice for bulk image-to-PPT conversion and frequent delivery. Try Codia NoteSlide →

How to Read This Documentation

If you just want to get started quickly, begin with the Quick Start.

If you need to install the skill, configure models, or connect it to different agents, see Installation and Configuration.

If you want to understand the complete generation process, confirmation checkpoints, and quality control, see the Standard Workflow.

If you are already using the skill and have encountered a problem, see the FAQ.

Pages

• Quick Start: The shortest path for first-time users, example commands, and output files.
• Design Philosophy: Why the skill uses image-based presentations, staged confirmation, and a two-skill design.
• Installation and Configuration: Installation and update methods for Codex, OpenClaw, Claude Code, and Hermes Agent, plus API/CLI fallback configuration.
• Standard Workflow: The complete process, from confirming the outline, style, backend, and sample slide to generating and assembling the full deck.
• Styles and Personal Style Library: Previews of the 12 built-in styles, reproducing a style from reference materials, and saving styles you like to your personal style library for long-term reuse.
• FAQ: Common questions about editability, API keys, sample slides, inserting source materials, and revising individual slides.
• Example Prompts: Reusable prompts for turning articles into presentations, thesis defenses, executive reports, specified styles, and single-slide revisions.

Key Features

• Image-based presentation generation: Each slide is a complete 16:9 slide image, ideal for scenarios that require strong visual expression and a consistent style.
• Staged confirmation workflow: Confirm the outline, visual style, image-generation method, and sample slide before generating the full deck to reduce rework.
• 12 built-in styles: Options include clean professional, scientific defense, hand-drawn technical explanation, McKinsey-style, party and government red, and teaching courseware. See Styles and Personal Style Library.
• Style matching from reference materials: The skill can review a user-provided presentation, PDF, or screenshots, understand the visual style of each page, and generate a similar style.
• Personal style library: Styles you like can be saved to ~/.codex-ppt-skill/references/, outside the skill installation directory. They remain available after skill updates and can be reused by name in future projects.
• Place specified source materials on designated slides: You can assign original paper figures, experiment results, architecture diagrams, or screenshots to specific slides.
• Multiple agent environments: In addition to Codex, the skill works with agents that support SKILL.md, including Claude Code, OpenClaw, and Hermes Agent.
• Automatic PowerPoint assembly: The skill generates outline.md, individual slide images, and speech.md, then assembles everything into a .pptx file.
• Third-party API support for text models and the gpt-image-2.5-flare image-generation model.
• Companion speaker notes: Speaker notes are generated and inserted into the PowerPoint notes pages by default.
• Targeted post-generation edits for specific slides that need improvement. See the FAQ.

Use Cases

• Turning technical articles into presentation decks
• Turning papers, research reports, or survey materials into presentations
• Turning course notes into teaching slides
• Product introductions, business reports, and project summaries
• Thesis defenses, project applications, midterm reviews, and final acceptance presentations
• Image-based presentations that require a consistent visual language

Important Notes

Codex PPT generates image-based presentations. They offer strong visual consistency, but the text, charts, and shapes on a slide cannot be edited individually as they can in a traditional PowerPoint file.

If you need to convert the result into an editable presentation, you can use image-to-editable-ppt-skill after generation.

This skill requires an available built-in image tool or compatible image API. See Installation and Configuration.

Related Links

• GitHub repository: https://github.com/ningzimu/codex-ppt-skill
• ClawHub page: https://clawhub.ai/ningzimu/codex-ppt
• Use case showcase: https://github.com/ningzimu/codex-ppt-skill/issues/34
• Editable presentation conversion skill: https://github.com/ningzimu/image-to-editable-ppt-skill