codex-ppt-skill：把文章变成整页图片式的 PPT

文章写完了，明天就要分享，PPT 还停在空白标题页。codex-ppt-skill 和大多数 PPT 生成工具走了相反的路线：每一页幻灯片都是一张完整生成的 16:9 图片，视觉风格天然统一，不需要你花一晚上手工调格式。

为什么这个 Skill 重要

多数 AI PPT 工具给你的是可编辑的占位模板，然后你花一晚上修。这个 skill 生成的是整页图片——整套 PPT 看起来像设计师做的，但页面元素本身不可直接编辑。它为 Codex 而建，在 Codex 里可以优先使用内置的生图和编辑图能力；同时也支持 Claude Code、OpenClaw、Hermes Agent 以及其他兼容 SKILL.md 的 agent。在这些非 Codex 环境中，通常需要配置 gpt-image-2、第三方生图 API 或 OpenAI 兼容的生图接口。

流程是刻意分阶段的。在整套生成开始前，skill 会和你确认大纲、页数、视觉风格、生图后端和一页样张——这正是十页生成不至于跑偏成十页错页的原因。

安装

README 推荐用 skills CLI 手动安装到 Codex 的全局 skills 目录：

npx -y skills@latest add ningzimu/codex-ppt-skill \
  --skill codex-ppt \
  --agent codex \
  --global

安装完成后重启 Codex。Claude Code 用同一条命令、把 --agent 换成 claude-code，会装到 ~/.claude/skills/codex-ppt。也可以把安装这件事直接交给 agent，发一句话即可："请帮我安装这个 codex-ppt skill，链接是：https://github.com/ningzimu/codex-ppt-skill"。

实战：把一篇技术文章做成 10 页 PPT

1. 把素材路径交给 skill——文章、报告、论文、课程笔记、Markdown、大纲、PDF、Word 文档都可以作为输入：

请使用 codex-ppt skill 把 /path/to/article.md 做成 10 页左右的 PPT。

2. skill 会先读内容、先规划。它生成 outline.md，包含页数、标题和每页要点，并在生成任何图片之前请你确认。

3. 你来选视觉方向。内置 12 种风格参考——清爽专业、科研答辩、电子墨水杂志、手绘技术解释、数据仪表盘、麦肯锡风格、教学课件等——这一步会给出 2-3 个选项。README 特别推荐不想写风格提示词的人从手绘技术解释风开始。

4. 首次生图前，skill 会说明将使用的生图后端并请你确认。在有订阅的 Codex 里，内置生图通常不需要 API key；第三方 OpenAI 兼容接口是回退路线。

5. 它会先生成一页样张。在这一页上判断字体清晰度、版式节奏和文字质量——这是改方向成本最低的时刻。

6. 样张确认后，skill 逐页生成其余幻灯片，检查文字清晰度、风格一致性和内容完整性，生成 speech.md 演讲稿，再用本地脚本组装成 .pptx。样张通过后也可以并发执行，一个子 agent 负责一页。

每个 PPT 会落在一个独立的项目目录里：

my-deck/
├── origin_image/     # 每页最终采用的图片：slide_01.png、slide_02.png……
├── outline.md        # 已确认的大纲
├── speech.md         # 演讲稿，会写入 PPT 每页备注
└── my-deck.pptx      # 组装完成的 PPT

第二个值得知道的用法是风格复刻。把你喜欢的截图、PDF 或 PPT/PPTX 文件交给 agent，它会先分析配色、版式、字体和视觉元素，再按这个风格生成新 PPT。某套 PPT 让你满意后，可以让它把风格保存到 ~/.codex-ppt-skill/references/ 的个人风格库——同名时个人风格优先于内置风格，而且风格库存放在安装目录之外，更新 skill 不会丢失。

技巧

• Codex 内置生图的分辨率较低，也不能手动指定分辨率。想让文字更清晰——尤其是文字多的页面——切换到 gpt-image-2 API 路线，它默认 2K 16:9 横屏，还可以要求 4K。
• 改一页，而不是改整套。只有第 7 页不满意时，直接让 agent 针对那一页细致修改，不必整套重新生成。
• 给指定页预留真实素材。论文原图、实验图表、截图和架构图可以在大纲里指定放到某一页，页面会围绕这些图适配版式。
• 分阶段流程感觉慢是故意的。确认大纲、风格和一页样张只需几分钟；到第九页才发现风格不对，代价是整套重做。

何时不用这个 Skill

如果 PPT 之后还需要现场编辑——要在 PowerPoint 里点开文本框改字——整页图片就是错误的取舍，PNG 上点不出文本框。README 建议用同一作者的 image-to-editable-ppt-skill 把生成的 PPT 转成可编辑幻灯片，参见 image-to-editable-ppt-skill 教程。而如果是视觉效果无所谓的内部小分享，普通的 markdown 幻灯片仍然更快。

查看 排行榜 了解更多 skill。