Skip to content
SkillScript-led2,105 tokens in use

Codex PPT

Turns articles, papers and notes into visually unified PowerPoint decks where every slide is a generated 16:9 image, with approval gates and speaker notes.

8,068 stars on the repository MIT Licenseningzimu/codex-ppt-skill · skills/codex-ppt
npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent codex --global
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Codex PPT costs

28tokens idle
2,105tokens in use
15,749tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/assemble_ppt.py, scripts/codex_ppt_runtime.py, scripts/image_gen.py, scripts/image_providers/__init__.py, scripts/image_providers/atlascloud.py, scripts/image_providers/base.py, scripts/image_providers/factory.py, scripts/image_providers/openai_compatible.py, scripts/prepare_slide_prompts.py, scripts/record_slide_blocker.py, scripts/record_slide_dispatch.py, scripts/record_slide_result.py, scripts/remove_chroma_key.py, scripts/slide_job_status.py, scripts/slide_run_state.py.

Touches

shelldetectednetworkdetectedwrites filesdetectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure23/25
  • Examples3/15
  • Output10/15
  • Size15/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Fair
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    .clawhubignore
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/assemble_ppt.py, line 31
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/assemble_ppt.py, line 208
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    scripts/codex_ppt_runtime.py, line 45
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/codex_ppt_runtime.py, line 138

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity80
  • Maintenance88
  • Community44
  • Maturity28
  • Momentum40

Codex PPT creates image-based decks. Each slide is a complete 16:9 picture produced by an image model, and a bundled script assembles the pictures into a .pptx file with speaker notes. The result looks consistent from page to page, and its text and shapes cannot be edited one by one.

The workflow has approval gates: you confirm the outline, one of two or three style directions and the image backend, and you approve one sample slide before the full set is generated. After that, each remaining slide goes to its own subagent when the runtime has them.

What You Get

  • A project folder with origin_image slide PNGs, outline.md, speech.md and the final .pptx
  • Speaker notes written into each slide’s notes area
  • A style chosen from 12 built-in references or copied from an image, PDF or PPT you supply
  • Slides that include your own figures, charts or screenshots in the pages you name
  • Job and run-state files that show which slides are recorded, accepted or blocked

Common Use Cases

  • Turn a technical article into a sharing deck
  • Convert a paper into a defense presentation with its original figures on chosen pages
  • Make course notes into teaching slides
  • Build a business report or product intro with a consistent look
  • Reproduce the look of a reference deck for a new topic

What Makes It Unique

The skill forbids local drawing and layout code as a way to make slides: every final image must come from the confirmed image backend, and state is recorded by scripts, not by chat messages. It also supports a personal style library kept outside the install folder, so styles survive updates.

Under The Hood

SKILL.md is an orchestration contract that points to docs for each phase and to a worker prompt for slide subagents. The agent runs bundled Python scripts to prepare slide jobs, record results, and assemble the PPTX. Images come from the built-in image tool of the host, or from a command line fallback that calls an OpenAI-compatible image API with an API key and base URL that you configure, stored in an env file in your home folder. The agent writes the project folder, run state files and your personal style library, and sends your slide prompts and any supplied images to the image service.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers