uuoov/ppt-image-share-builder 是一个 image2-first 的 Codex skill,用来把课程汇报主题、资料文件和参考 PPT 风格做成逐页页面图片、contact sheet、PPTX 承载文件和 10 分钟讲稿;GitHub 入口是 https://github.com/uuoov/ppt-image-share-builder,Release ZIP 在 https://github.com/uuoov/ppt-image-share-builder/releases/latest,手动 clone 地址是 https://github.com/uuoov/ppt-image-share-builder.git。
先把它的用途摆正:它不是把每个文本框和图形都重建成可编辑对象的工具,而是先生成 16:9 的 PPT 页面图片,再把最终图片全屏插入 PowerPoint。PPTX 在这里是交付承载文件,核心视觉来自 image2 或同类图片模型生成的页面图片。

如果 Codex 环境里有内置 skill installer,README 推荐直接用安装脚本。macOS / Linux 命令如下:
python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo uuoov/ppt-image-share-builder --path . --name ppt-image-share-builder
Windows PowerShell 对应命令如下:
python "$env:USERPROFILE.codexskills.systemskill-installerscriptsinstall-skill-from-github.py" --repo uuoov/ppt-image-share-builder --path . --name ppt-image-share-builder
手动 clone 也很直接。macOS / Linux 放到 ~/.codex/skills/ppt-image-share-builder,Windows 放到 $env:USERPROFILE.codexskillsppt-image-share-builder。安装后重启 Codex,让 skill 元数据重新加载。
git clone https://github.com/uuoov/ppt-image-share-builder.git ~/.codex/skills/ppt-image-share-builder
不想 clone 时,就从 Releases 下载 ZIP,解压后放进 Codex skills 目录。这个入口适合只想使用稳定包、不打算改仓库文件的人。
第一次调用时直接点名 $ppt-image-share-builder。给它课程主题、受众、参考 PPT、资料路径、必须覆盖的关键词和不想出现的内容,比只写“帮我做个 PPT”更稳。
使用 $ppt-image-share-builder。
我需要做一个 10 分钟课堂汇报。
主题是:<你的主题>
受众是:<课程/老师/同学>
参考 PPT 在:<文件路径>
资料包括:<docx/pdf/txt/网页链接>
必须覆盖的关键词:<关键词>
请帮我整理资料、分析参考 PPT 风格、生成 12-14 页页面图片、做 contact sheet、插入 PPTX,并写 10 分钟汇报稿。
README 里也给了英文快速入口:让它把 course topic、source files 和 reference PPT style 变成 image2 page prompts、generated PPT page images、PPTX wrapper 和 timed presentation script。中文使用时,不必照搬英文,只要信息足够完整。
仓库里的辅助脚本不替代 image2。它们只做图片生成之后的事:生成 contact sheet,或者把最终页面图片插入 PPTX。脚本依赖很轻,只有 pillow>=9.0 和 python-pptx>=0.6.21。
python -m pip install -r requirements.txt
已有编号页面图片后,可以先做总览图:
python scripts/make_contact_sheet.py --input-dir examples/medical-device-flight-check/images -o examples/medical-device-flight-check/contact-sheet-demo.jpg
总览图检查通过后,再把图片插入 PPTX 承载文件:
python scripts/images_to_pptx.py --input-dir examples/medical-device-flight-check/images -o examples/medical-device-flight-check/demo-deck.pptx

顺利完成后,应能看到类似这些文件:<主题>_image2逐页大纲.md、outputs/<topic-slug>-images/slide-XX-*.png、contact-sheet-*.jpg、<主题>.pptx、<主题>_10分钟汇报稿.md。其中 contact sheet 用来快速看页数、风格、中文错误、重复页、无意义标记和不该出现的内容。
如果某一页内容太空,先补页面观点、案例、依据和图表结构;如果风格不统一,先写清风格锁,再让后续页面沿用;如果页面里有奇怪符号、随机标签或未要求的 Q&A,只重生成受影响页面即可。
uuoov/ppt-image-share-builder 适合课堂汇报、课程展示和报告型 PPT:它把资料整理、风格跟随、页面图片、总览 QA、PPTX 承载和限时讲稿放在同一条链路里。安装入口确认后,第一轮先用示例目录验证 contact sheet 和 PPTX wrapper,再拿自己的资料开工,会更稳。