agentictaskx/ppt-to-course 是一个 Claude Code skill，用来把 PPTX 或 PDF slide deck 转成互动式单页 HTML 课程，并可选导出长图 PNG；入口在 GitHub 仓库，网页 Code 菜单可下载 ZIP，也能用 git clone https://github.com/agentictaskx/ppt-to-course.git 拉到本地，真正要放进 Claude 技能目录的是仓库里的 skill/ 目录。

这个仓库默认分支是 master，根目录放了 CLAUDE.md、DECISIONS.md、SESSION-BOOTSTRAP.md 和一个 skill/ 文件夹。安装时不要只复制根目录说明文件，应该把 skill/SKILL.md、skill/scripts、skill/build、skill/templates、skill/themes 一起放到 ~/.claude/skills/ppt-to-course。

把 skill 放到正确目录

克隆仓库后，可以这样复制：

git clone https://github.com/agentictaskx/ppt-to-course.git
cd ppt-to-course
mkdir -p ~/.claude/skills/ppt-to-course
cp -R skill/* ~/.claude/skills/ppt-to-course/

复制后建议开启新的 Claude Code 会话，再用触发词试运行。SKILL.md 写到的触发包括 ppt to course、slides to course、convert this presentation、presentation to course、pdf slides to course 等。

先装抽取和构建依赖

PPTX 和 PDF 抽取依赖 Python，HTML 编译依赖 Node.js。安装 Python 依赖：

pip install -r ~/.claude/skills/ppt-to-course/scripts/requirements.txt

这个文件对应 python-pptx、PyMuPDF、Pillow、pytesseract 等。Node.js 18+ 用于运行 build/compile.js。如果要把 HTML course 导成长图 PNG，再装 Puppeteer：

npm install puppeteer

OCR 不是每次都必须。扫描件或图片型页面需要 Tesseract；文本型 PPTX/PDF 即使没有 Tesseract，也能先完成可抽取文本的部分。

第一次用 PPTX 试

直接给文件即可：

ppt to course

Here's my presentation: quarterly-review.pptx

skill 会先跑抽取脚本：

python ~/.claude/skills/ppt-to-course/scripts/extract-pptx.py <file.pptx> <output_dir>

抽取后会得到 slide-profile.json、assets/ 和 references/。slide-profile.json 记录每页文字、图片、表格、图表、speaker notes、布局提示；references/ 是每页参考 PNG，用来检查文字抽取没覆盖的图表或视觉信息。

PDF 输入怎么走

PDF 入口类似：

slides to course

Convert this PDF: strategy-deck.pdf

对应脚本是：

python ~/.claude/skills/ppt-to-course/scripts/extract-pdf.py <file.pdf> <output_dir>

PDF 抽取会先尝试文本解析，碰到扫描页或图片重的页面再走 OCR fallback。旧版 .ppt 文件要先转换成 .pptx，或者另存为 PDF 后再处理；SESSION-BOOTSTRAP.md 也明确提到 python-pptx 只处理 .pptx。

看四个产物是否齐全

运行过程中最该看的不是一开始的描述，而是四个产物：slide-profile.json、course-content.json、output/course.html 和可选的 output/infographic.png。前两个说明信息抽取和课程结构是否成立，后两个说明编译和导出是否成功。

构建命令是：

node ~/.claude/skills/ppt-to-course/build/compile.js course-content.json --output ./output --mode both

它会生成单文件 output/course.html，也会生成便于迭代的 output/dev/。如果要导出长图 PNG：

node ~/.claude/skills/ppt-to-course/scripts/export-png.js output/course.html output/infographic.png

主题和课程结构怎么选

内置主题有 default、science、coding、finance、engineering、medical、humanities。主题 JSON 不只是换颜色，而是影响比喻方式、quiz 风格、语气和概念演员。视觉模板保持一致，主题更多影响内容生成。

课程一般会拆成 4 到 7 个 module：开场和大图景、核心概念、概念连接、细节和证据、实际影响、挑战和边界、回顾与下一步。大 deck 可以按 section divider 拆模块，避免一次生成太长导致后段质量下降。

边界要提前记住

这个 skill 不要求手写 HTML、CSS 或 JavaScript。SKILL.md 明确要求生成符合 schema 的 JSON，由 build/compile.js 负责组装 HTML。图片读取也有一条硬规则：参考 PNG 和素材图片要一张一张读，不要并行读取多张图片。

图表、简系图、表格优先重建为 HTML/SVG；照片、复杂插图、截图和 logo 更适合嵌入原图。无论重建还是嵌入，都要配描述文字，让课程脱离讲者也能被理解。

agentictaskx/ppt-to-course 的入口看起来像一个普通转换器，真正的用法是“先抽取，再生成课程 JSON，再编译 HTML”。把 skill/ 目录复制对、把 PPTX/PDF 依赖装好、把四个产物核对一遍，第一次试跑就会清楚很多。