https://github.com/ningzimu/codex-ppt-skill
Codex skill for generating image-based PowerPoint decks with gpt-image-2
https://github.com/ningzimu/codex-ppt-skill
Last synced: about 2 months ago
JSON representation
Codex skill for generating image-based PowerPoint decks with gpt-image-2
- Host: GitHub
- URL: https://github.com/ningzimu/codex-ppt-skill
- Owner: ningzimu
- License: mit
- Created: 2026-04-26T07:34:32.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-08T03:41:10.000Z (about 2 months ago)
- Last Synced: 2026-05-08T23:48:42.035Z (about 2 months ago)
- Language: Python
- Size: 18.3 MB
- Stars: 42
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-agent-skills - codex-ppt-skill - Codex skill for creating HTML presentation decks and slide-style visual documents. (Diagram and Visual Skills)
README
# Codex PPT Skill
[](README_en.md)
一个面向 Codex 的 PPT 生成 skill。它把文章、报告、论文、课程笔记等内容转换成“整页图片式”的演示文稿：先规划大纲和视觉风格，再使用 Codex 内置的 `gpt-image-2` 生成每页幻灯片图片，最后用本地脚本组装为 `.pptx`。
## 特点
- 使用 Codex 内置的 `gpt-image-2` 生图和编辑图能力生成每页幻灯片图片
- 图片式 PPT：每页幻灯片是一张完整 16:9 图片，适合强视觉表达
- 风格参考库：内置清爽专业、科研答辩、电子墨水杂志、手绘技术解释、仪表盘等多种风格说明
- 整套 PPT 保持统一视觉语言，但每页会按内容语义调整版式，避免机械重复
- 本地组装脚本：将 `slide_01.png`、`slide_02.png` 等图片打包成 PowerPoint
## 目录结构
```text
codex-ppt-skill/
├── README.md
├── README_en.md
├── LICENSE
├── assets/
│ └── style-previews/
└── skills/
└── codex-ppt/
├── SKILL.md
├── requirements.txt
├── scripts/
│ └── assemble_ppt.py
└── references/
├── 清爽专业风.md
├── 创意杂志风.md
├── 电子墨水杂志风.md
├── 科研答辩风.md
├── 手绘技术解释风.md
├── 数据仪表盘风.md
└── ...
```
## 安装
推荐直接在 Codex 会话中说：
```text
请使用 skill-installer 从 https://github.com/ningzimu/codex-ppt-skill 安装 codex-ppt，skill 路径是 skills/codex-ppt。
```
安装完成后，重启 Codex 让新 skill 生效。
如果你想手动安装，也可以直接运行 Codex 内置的安装脚本。这个仓库的 skill 根目录是 `skills/codex-ppt`：
```bash
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo ningzimu/codex-ppt-skill \
--path skills/codex-ppt
```
如果你是在本地开发这个仓库，也可以把 skill 目录链接到 Codex skills 目录：
```bash
mkdir -p ~/.codex/skills
ln -s /path/to/codex-ppt-skill/skills/codex-ppt ~/.codex/skills/codex-ppt
```
## 使用方式
在 Codex 中提出类似请求：
```text
请使用 codex-ppt 把 /path/to/article.md 做成 10 页左右的 PPT，风格偏商务专业。
```
skill 会按以下流程执行：
1. 阅读内容并规划 PPT 大纲
2. 确认页数、标题和每页要点
3. 给出 2-3 个视觉风格选项，并推荐一个让用户确认
4. 使用 `gpt-image-2` 生成 1 页样张，让用户确认风格、版式节奏和文字质量
5. 创建 PPT 项目目录
6. 使用 `gpt-image-2` 逐页生成全部幻灯片图片
7. 检查文字清晰度、风格一致性和内容完整性
8. 生成 `outline.md` 和 `speech.md`
9. 使用 `assemble_ppt.py` 组装 `.pptx`
## 使用技巧
- 如果生成的幻灯片图片比较模糊，尤其是文字较多的页面，可以让 Codex 改用 4K 分辨率生成图片。默认分辨率在高文字密度页面上可能会导致小字不够清晰。
- 如果只是不满意某一页的内容、排版、配色或文字表达，可以直接让 Codex 针对这一页做细致修改，不需要整套 PPT 重新生成。
- 你也可以上传一张喜欢的 PPT 风格截图或参考图，让 Codex 模仿它的配色、版式、字体气质和视觉元素来生成整套 PPT。
## 生成效果
下面是一套技术分享 PPT 的生成效果示例。每页都是由 `gpt-image-2` 生成的完整 16:9 幻灯片图片，再由本地脚本组装为 PPTX。
## 风格示例
以下是已生成预览图的风格，示例图均由 `gpt-image-2` 生成，用于帮助用户在开始制作前选择视觉方向。
| 清爽专业风 | 创意杂志风 |
| --- | --- |
|  |  |
| 电子墨水杂志风 | 数据仪表盘风 |
|  |  |
| 复古扁平插画风 | 手绘技术解释风 |
|  |  |
| 手绘白板风 | 温暖手工风 |
|  |  |
| 科研答辩风 | |
|  | |
## 输出结构
每个 PPT 会生成一个独立项目目录：
```text
{基础目录}/{PPT名称}/
├── origin_image/
│ ├── slide_01.png
│ ├── slide_02.png
│ └── ...
├── outline.md
├── speech.md
└── {PPT名称}.pptx
```
`origin_image/` 只放正式页图片，并按 `slide_01.png`、`slide_02.png` 这样的顺序命名。样张确认时也直接使用对应页的正式文件名；如果要保留废稿或对比图，放到项目根目录或单独的 `drafts/` 目录，不要放进 `origin_image/`。
`speech.md` 会在组装时写入 PPT 的每页备注。建议使用 `## Slide 1: 标题`、`## Slide 2: 标题` 这样的标题格式，脚本会按页码匹配。
## 适用场景
- 技术文章转分享 PPT
- 论文或报告转演示稿
- 课程笔记转课件
- 科研项目申报、中期检查、结题验收和论文答辩
- 商业汇报、产品介绍、调研总结
- 需要强视觉统一性的图片式演示文稿
## 许可证
MIT
## Star History
[](https://www.star-history.com/#ningzimu/codex-ppt-skill&Date)