codex-ppt-skill README

The project's README from github.com/ningzimu/codex-ppt-skill. As one markdown file: README.md.

Codex PPT Skill

简体中文 · English · 한국어

文档 支持 ClawHub ClawMama GitHub stars GitHub forks

一个面向 Codex 的 PPT 生成 skill,也可在 Claude Code、OpenClaw、Hermes Agent 等支持 SKILL.md 的 agent 中使用;在这些非 Codex 环境中通常需要配置 gpt-image-2、第三方生图 API 或 OpenAI 兼容格式的生图接口。它把文章、报告、论文、课程笔记等内容转换成“整页图片式”的演示文稿:先规划大纲和视觉风格,再生成每页幻灯片图片,最后用本地脚本组装为 .pptx。

赞助

Atlas Cloud 感谢 Atlas Cloud 赞助本项目。AtlasCloud 是多模态 AI 推理平台,提供统一 API 接入图片生成、视频生成和大语言模型等能力;本 skill 已支持通过现有 API key、base URL 和模型名配置接入 AtlasCloud 的 GPT Image 2 生图和编辑图接口,按量计费,开箱即用。完整模型列表可查看 Atlas Cloud 模型页。

温馨提示

[!TIP] 本 skill 负责从文章、报告、大纲或想法生成图片式 PPT,适合强视觉表达,但页面元素本身不可直接编辑。如果你需要进一步转换成可编辑 PPT,可以在生成完成后尝试使用 image-to-editable-ppt-skill 进行转换。

关于 codex-ppt 和 image-to-editable-ppt 这两个技能的详细介绍,参见 skill_duo_intro.pdf。该 PPT 由 codex-ppt skill 生成,提示词为:“请分别阅读 Codex PPT和 Image to Editable PPT 这两个技能的内容,然后用 Codex PPT 帮我做一个PPT吧,20页,每个技能的介绍10页。”

另外,关于这个 PPT Skill 设计和调优的实践经验,可以看这篇文章:2000 个 GitHub Star 换来的经验:好的 AI Skill 是调出来的,不是写出来的。

[!NOTE] 想查看更多用户用这个 skill 做出的 PPT 效果,可以前往置顶 Issue 的案例展示区:欢迎分享 codex-ppt 使用案例和 PPT 效果。

这个 skill 主要给大家提供一个还不错的 PPT 生成流程。为了尽量通用,它的流程设计会稍微复杂一些;复杂也会带来不稳定性或者冗余性。比如它同时兼容 Codex 内置生图和 API/CLI fallback 生图,也会兼容有无子 agent 可用这两种情况,但大部分人日常使用时其实只会固定走其中一条路线。

建议大家在走通自己常用的路线之后,让 AI 帮你改一下这个 skill,把你的偏好固定下来,省得每次都重新选择。比如固定使用内置生图或固定使用某个 API,固定是否使用子 agent,固定常用输出目录、风格、页数节奏等。

另外,如果你在做 PPT 的过程中遇到了自己喜欢的版式或排版,无论是这个 skill 做出来的,还是从别的地方找到的 PPT 风格图片,都可以让 AI 保存到你的个人风格库(~/.codex-ppt-skill/references/)里,逐步沉淀自己的风格。个人风格库存放在 skill 安装目录之外,更新或重装 skill 都不会丢失。Skills 本质上是非常个性化的流程,鼓励大家在使用这个 skill 的基础上,按自己的偏好持续调优,让它更适配自己的工作流。

关于 skills 如何设计和使用,可以参考 good-skill-design.pptx。这个 PPT 也是用本 skill 做的,采用的是手绘技术解释风;内容基于 Claude 在设计 skills 方面的最佳实践文章 The Complete Guide to Building Skills for Claude。祝大家玩得愉快!

特点

生成效果

下面是一套技术分享 PPT 的生成效果示例。每页都是由 gpt-image-2 生成的完整 16:9 幻灯片图片,再由本地脚本组装为 PPTX。

生成 PPT 效果示例

下面是一套论文答辩风案例,来源于论文 Attention Is All You Need。它展示了如何在指定页中插入论文原始图片作为输入素材,例如模型架构图、attention 模块图和 attention 可视化图,并围绕这些图片生成统一风格的 PPT(见 Issue #14)。

论文原图插入案例

风格示例

以下是已生成预览图的风格,示例图均由 gpt-image-2 生成,用于帮助用户在开始制作前选择视觉方向。

清爽专业风 创意杂志风
清爽专业风 创意杂志风
电子墨水杂志风 数据仪表盘风
电子墨水杂志风 数据仪表盘风
复古扁平插画风 手绘技术解释风
复古扁平插画风 手绘技术解释风
手绘白板风 温暖手工风
手绘白板风 温暖手工风
科研答辩风 麦肯锡风格
科研答辩风 麦肯锡风格
党政红风格 教学课件风
党政红风格 教学课件风

输出结构

每个 PPT 会生成一个独立项目目录:

{基础目录}/{PPT名称}/        # 当前 PPT 的独立项目目录
├── origin_image/           # 正式幻灯片图片目录,只放最终采用的页面
│   ├── slide_01.png        # 第 1 页幻灯片图片
│   ├── slide_02.png        # 第 2 页幻灯片图片
│   └── ...                 # 后续页面图片,按页码顺序命名
├── outline.md              # 经确认的 PPT 大纲、页数、每页标题和要点
├── speech.md               # 演讲稿,会写入 PPT 每页备注
└── {PPT名称}.pptx          # 最终组装生成的 PowerPoint 文件

你可以在 origin_image/ 里查看每一页最终采用的幻灯片图片,文件会按 slide_01.png、slide_02.png 这样的顺序排列。想预览整套 PPT 的视觉效果,或只挑某一页继续修改时,直接看这里最方便。

speech.md 是配套演讲稿。生成 .pptx 时,这些内容会自动写入每页 PPT 的备注区,你可以在 PowerPoint 里直接查看、修改,或演示时作为讲稿使用。

适用场景

安装

一句话安装

【推荐】可以直接把下面这句话发给你的 Agent,让它帮你安装:

请帮我安装这个 codex-ppt skill,链接是:https://github.com/ningzimu/codex-ppt-skill

手动安装到 Codex

如需手动安装到 Codex,可以使用 skills CLI 安装到 Codex 的全局 skills 目录:

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

安装完成后,重启 Codex 让新 skill 生效。

也可以从 GitHub Releases 下载 codex-ppt-skill-v*.zip,解压后把其中的 codex-ppt 文件夹放到 ~/.codex/skills/codex-ppt,然后重启 Codex。

如果你是在本地开发这个仓库,也可以把 skill 目录链接到 Codex skills 目录,方便实时调试修改:

mkdir -p ~/.codex/skills
ln -s /path/to/codex-ppt-skill/skills/codex-ppt ~/.codex/skills/codex-ppt

OpenClaw

可以通过 ClawHub 安装:

openclaw skills install codex-ppt

ClawHub 页面:clawhub.ai/ningzimu/codex-ppt

如果使用 OpenClaw 的 skill allowlist,需要把 codex-ppt 加入允许列表。

Claude Code、Hermes Agent

这些 agent 都可以读取 SKILL.md 形式的 skill。也可以使用 skills CLI 安装:

# Claude Code
npx -y skills@latest add ningzimu/codex-ppt-skill \
  --skill codex-ppt \
  --agent claude-code \
  --global

# Hermes Agent
npx -y skills@latest add ningzimu/codex-ppt-skill \
  --skill codex-ppt \
  --agent hermes-agent \
  --global

常见目标目录是:Claude Code 使用 ~/.claude/skills/codex-ppt,Hermes Agent 使用 ~/.hermes/skills/codex-ppt。

如果你是在本地开发这个仓库,也可以用软链接替代复制,方便实时调试修改。

更新

重新执行一遍上面对应的安装命令即可覆盖为最新版本,也可以直接让 agent 帮你更新:

请帮我更新 codex-ppt skill 到最新版本,仓库是:https://github.com/ningzimu/codex-ppt-skill

更新后重启 agent 生效。API key 配置(~/.codex-ppt-skill/.env)和个人风格库(~/.codex-ppt-skill/references/)都在 skill 安装目录之外,更新或重装不会丢失。

生图模型配置

[!TIP] 你可以先正常使用 Codex PPT 开始制作 PPT。一般不需要自己手动配置生图模型;当流程走到“选择生图后端”时,AI 会根据当前环境判断是否需要配置,并在需要时引导你提供相关信息。

  • 如果你使用的是 Codex 内置图片生成能力,通常不需要额外配置 API key。
  • 如果你确定要使用第三方供应商或 OpenAI 兼容中转站,请让 AI 先阅读 生图模型配置指南,再配置 API key、base URL 和模型名。

指定图片分辨率、提高质量或要求修改某一页,本身不会触发第三方 API 配置。如果你是通过 GPT 会员订阅使用 Codex,并且 Codex 内置图片生成工具可用,通常可以继续使用内置生图能力,不需要准备 API key。

使用方式

在 Codex、Claude Code、OpenClaw 或 Hermes Agent 中明确指定使用 codex-ppt skill,例如:

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

skill 会按以下流程执行:

  1. 阅读内容并规划 PPT 大纲
  2. 生成 outline.md,并请求你确认页数、标题和每页要点
  3. 给出 2-3 个视觉风格选项,并推荐一个让用户确认
  4. 在首次生图前说明将使用的生图方式,并请求你确认
  5. 使用确认后的图片生成后端生成 1 页样张,让用户确认风格、版式节奏和文字质量
  6. 创建 PPT 项目目录
  7. 使用同一图片生成后端逐页生成全部幻灯片图片
  8. 检查文字清晰度、风格一致性和内容完整性
  9. 生成 speech.md
  10. 使用 assemble_ppt.py 组装 .pptx
  11. 可选:如果生成的 PPT 风格你很喜欢,可以保存到风格库;如果使用的是内置风格,则无需重复保存

使用技巧

单页局部修改示意:打开 PPT、点击标注,并框选需要修改的位置

我的其他项目

支持

遇到问题?请查看使用文档,加入 CodexPPT,或提交 Issue。

许可证

MIT

致谢

感谢 LinuxDO 社区的支持。

codex-ppt-skill (ningzimu/codex-ppt-skill)

pptx
Searching Database…

What is this?A SKILL.md-based skill for Codex (and other compatible agents like Claude Code, OpenClaw and Hermes Agent) that turns articles, reports, papers or course notes into full-page image-style slide decks: it plans an outline and visual style, generates each slide as an image with gpt-image-2, then assembles everything into a .pptx with a local script.
Is this a standalone app, or does it plug into an existing AI agent?It's a skill package (SKILL.md), not standalone software. It installs into agent harnesses such as Codex, Claude Code, OpenClaw and Hermes Agent, and the host agent drives the whole workflow while a bundled Python script handles the final PPTX assembly.
How do I install it into Codex or another agent?Use the skills CLI to install into your agent's skills directory (e.g. ~/.codex/skills/codex-ppt for Codex), or download the release zip and drop the codex-ppt folder in place; OpenClaw users install via ClawHub instead. Restart the agent afterward to load the skill.
Do I need a gpt-image-2 API key to use it?Not by default — inside Codex you can rely on its built-in image generation with no API key at all. An API key, base URL and model name are only needed if you switch to a third-party or OpenAI-compatible image backend, such as when using it outside Codex or wanting higher resolution.
Are the slides it produces editable afterward?No, the output is full-page slide images assembled into a .pptx, so text and elements can't be edited directly inside PowerPoint; the author's separate image-to-editable-ppt-skill can convert the result into an editable deck afterward. Codex's built-in image generator also defaults to lower resolution than the API-based fallback.
What kinds of presentations is this meant for?It targets turning technical articles, papers and reports into shareable decks, course notes into teaching slides, and academic/business material into defense, proposal or report presentations where strong visual consistency matters more than editable layout.
What built-in visual styles come with it?It ships with 12 built-in style references, including clean professional, academic defense, government red, teaching courseware, e-ink magazine, hand-drawn tech explainer, dashboard and McKinsey-style, so you can start without writing your own prompt.
Can I save and reuse my own slide style across projects?Yes — once you like a generated deck's style, you can save it to a personal library at ~/.codex-ppt-skill/references/, which lives outside the skill folder so it survives updates and takes priority over the built-in styles.
Does it also produce speaker notes?Yes, it generates a speech.md script and writes it into each slide's notes section when assembling the .pptx, so you can present directly from it or edit the notes afterward.
What kind of source material can I feed it?Articles, reports, papers, course notes, Markdown files, outlines, PDFs and Word documents can all be used as the starting input for a deck.
Creator
ningzimu
Size
44.3 MB
Stars
7K
Age
5mo
Commits · 90 Days