ningzimu/codex-ppt-skill
GPT-Image-2 PPT Generator Skill for Creating Image-Based PowerPoint Presentations in Codex and Other Skill-Compatible Agents
What it solves
Codex PPT Skill is designed to transform long-form content—such as articles, reports, papers, and course notes—into visually compelling presentation slides. It solves the problem of manually designing slides from scratch by automating the outline planning, visual style selection, and slide generation process.
How it works
The tool operates as a "skill" for AI agents (like Codex, Claude Code, OpenClaw, and Hermes Agent). It follows a structured, phased workflow:
- Planning: The agent reads the input material and creates a detailed outline (
outline.md) with titles and key points for each page. - Styling: The user confirms a visual style (either from 12 built-in presets or a custom style analyzed from uploaded reference images/PDFs).
- Generation: The agent generates each slide as a full-page image using an image generation backend (such as
gpt-image-2or other OpenAI-compatible APIs). - Assembly: A local Python script (
assemble_ppt.py) compiles these images into a final.pptxfile, while a separatespeech.mdfile provides the accompanying speaker notes.
Who it’s for
- Researchers and Students: For creating academic defense slides or project reports from papers.
- Professionals: For business reports, product introductions, and survey summaries.
- Educators: For converting course notes into teaching materials.
- Technical Writers: For turning technical articles into presentation decks.
Highlights
- Multi-Agent Compatibility: Works across various agents that support
SKILL.md(Codex, Claude Code, OpenClaw, Hermes Agent). - Custom Style Replication: Can analyze uploaded images or PDFs to replicate specific visual elements, colors, and layouts.
- Personal Style Library: Allows users to save successful styles to a local directory (
~/.codex-ppt-skill/references/) for future reuse. - Integrated Speaker Notes: Automatically generates a
speech.mdfile and embeds it into the PowerPoint notes section. - Image-Based Approach: Focuses on high-visual impact "full-page image" slides rather than editable text boxes, ensuring consistent professional aesthetics.
- Flexible Input: Supports a wide range of formats including Markdown, PDF, Word, and raw text.
Related
- Project
- Project
- Project
- Project
- Project