codex-ppt-skill Skill：一键把文章论文变成高颜值图片式PPT

一份 SKILL.md，让 AI 把论文和报告自动变成高颜值 PPT

codex-ppt-skill 是近期 GitHub 增长最快的视觉类 Skill 之一。它不是又一个”填表生模板”的 PPT 工具，而是一套完整的多阶段 AI 工作流：输入文章、报告或论文笔记，让 Agent 自动规划大纲、选视觉风格、用 GPT-Image-2 生成每页幻灯片图片，最后本地组装为可直接演示的 .pptx 文件。整个过程不需要手动排版，输出是整页图片式演示文稿，视觉一致性远高于传统模板填充方案。

功能与设计原则

codex-ppt-skill 的核心能力是把文字内容转换为”整页图片式”PPT。先规划大纲，再逐页生成 16:9 幻灯片图片，最后用 Python 脚本组装为 PPTX。设计原则有三个：低门槛输入（文章、报告、论文、课程笔记、Markdown、PDF、Word 都可以作为起点）；不强排，生成前必须确认大纲、风格和样张才能正式执行；可沉淀个人风格，用户可以把喜欢的版式保存为风格库，下次复用。

认可度

截至 2026-09-17，GitHub 星标约 6,000，来自多个来源的交叉验证（claudewave.com 收录时为 4.7K，heatdrop.ai 收录时为 6K，持续增长中）。该 Skill 在 lobehub.com 和 claudewave.com 等 Agent Skill 索引平台均有收录，被多个 Agent 生态推荐使用。

链接

GitHub：https://github.com/ningzimu/codex-ppt-skill

原作者

GitHub 用户 ningzimu，独立开发者。README 透露作者持”Skill 本质上是非常个性化的流程，鼓励大家在使用基础上按自己的偏好持续调优”的设计理念，并提供了配套工具链（codex-gpt-image、image-to-editable-ppt-skill 等）形成生态。

介绍

codex-ppt-skill 基于 SKILL.md 规范编写，兼容任何支持 Agent Skills 的 AI 助手，但在 Codex 环境中使用效果最佳，因为可以直接调用内置的 GPT-Image-2 图片生成能力，无需额外配置 API。

整体工作流为八步：阅读输入内容并规划大纲 → 生成 outline.md 供用户确认页数/标题/要点 → 提供 2-3 个视觉风格选项 → 确认生图后端和样张 → 逐页生成幻灯片图片 → 自检文字清晰度和风格一致性 → 生成 speech.md 演讲稿 → assemble_ppt.py 打包为 .pptx。

内置 12 种视觉风格：清爽专业、科研答辩、党政红、教学课件、电子墨水杂志、手绘技术解释、仪表盘、麦肯锡等，每种都有预览图参考。也支持上传喜欢的 PPT/图片让 AI 分析配色和版式，再按该风格生成新 PPT。个人风格库保存在 ~/.codex-ppt-skill/references/，独立于 Skill 安装目录，更新或重装不会丢失。

特点

• 多 Agent 支持：Codex、Claude Code、OpenClaw、Hermes Agent 均可安装，Codex 环境优先走内置生图
• 阶段化确认：生成前强制确认大纲、风格和样张，避免返工
• 内置 12 种视觉风格：附预览图，不会写提示词也能直接选
• 支持插入原始图片：论文图、架构图、实验截图等可指定到特定页面，页面自动适配
• 多 Agent 并发生成：确认样张后，支持子 Agent 并发生成多页并做自检
• 自动生成演讲稿：speech.md 内容在组装 PPTX 时写入每页备注区
• API Fallback 支持：非 Codex 环境中可配置 OpenAI 兼容接口调用 gpt-image-2.5-flare 等模型

使用方法

推荐安装方式（把这句话发给 Agent 即可）：

请帮我安装 codex-ppt skill，链接是：https://github.com/ningzimu/codex-ppt-skill

手动安装到 Codex：

npx -y skills@latest add ningzimu/codex-ppt-skill 
  --skill codex-ppt 
  --agent codex 
  --global
# 重启 Codex 使 skill 生效

Claude Code 安装：

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

OpenClaw 安装：

openclaw skills install codex-ppt

最小调用示例：

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

使用场景与人群

适用场景包括：技术分享 / 博客文章转演示 PPT、论文答辩演示、科研项目申报/结题汇报、商业汇报与产品介绍、课程课件制作。目标用户是：需要频繁制作 PPT 但不想手动排版的知识工作者；希望把 AI 生成内容快速转化为演示材料的开发者/研究员；需要 Agent 辅助制作高视觉统一度 PPT 的团队。

输入与输出案例

案例 1：技术文章转 PPT

• 输入：一篇关于 GitHub Trending 分析的 Markdown 文档，约 3000 字
• Agent 执行：读取内容 → 规划 8 页大纲（标题页、背景、榜单概览、重点项目解析、趋势总结、工具推荐、总结、Q&A） → 推荐”手绘技术解释风” → 生成一页样张确认 → 逐页出图 → 生成 speech.md → assemble_ppt.py 打包
• 输出：{PPT名称}/{PPT名称}.pptx（16:9 整页图片式幻灯片），speech.md（演讲稿，自动写入每页备注）

案例 2：论文答辩 PPT

• 输入：论文 Attention Is All You Need 的 PDF，附模型架构图、attention 可视化图
• Agent 执行：读取论文 → 规划答辩 PPT 大纲（背景、Transformer 架构、Attention 机制、实验结果、结论） → 在大纲中指定第 3 页插入模型架构图、第 4 页插入 attention 可视化图 → 生成并围绕图片适配主题和排版
• 输出：科研答辩风格 PPT，每页为 16:9 高清图片，风格统一，架构图和实验图作为素材嵌入对应页面

GitHub: https://github.com/ningzimu/codex-ppt-skill