我这次看 Nanzheng-SC/html-ppt-editable-skill，刚开始就觉得它和普通“生成 PPT”的 Skill 不太一样。它不是只给你一份静态 slides，而是先让 Agent 生成一套 HTML PPT，再让你在浏览器里直接点字修改、自动保存、导出完整 HTML。我按仓库说明把安装路径、快捷键和模板目录梳理了一遍，中间最容易踩的坑有三个：装错 skills 目录、把它和别的 PPT Skill 混用、以为浏览器编辑会直接改源模板。后面这几个点不提前搞清，真的会多花不少排查时间。

先弄明白它解决什么问题

这个 Skill 的核心不是“把 PPT 做得花一点”，而是解决一个更实际的问题：AI 生成 slides 后，人还能不能直接改。仓库 README 里写得很直白，它把 html-ppt-skill 的主题、模板、演讲者模式，和 frontend-slides 的浏览器内联编辑能力合在一起。

所以它适合这类场景：技术分享、课程课件、周报、pitch deck、小红书图文轮播、把 outline 变成能演示的 HTML slides。你按 E 进入编辑模式，直接点标题、段落、表格去改；改完后 Ctrl+S 或 Cmd+S 导出完整 HTML。这个体验和传统 PPTX 不一样，但对“先让 AI 做初稿，再人工微调文字”的工作流很顺。

安装前把环境看一眼

这不是浏览器插件，也不是 npm 项目模板。它是 Agent Skill，要放在 Agent 能读取的 skills 目录里。仓库明确面向 Codex、Claude Code、Cursor 以及兼容 Agent，但安装路径最常见的还是 Codex 的 ~/.codex/skills。

如果你准备走一行命令安装，需要本机有 npx，并且能执行 skills add。如果你的环境里没有 npx，别卡在这里，直接走手动 clone。这个我建议新手优先掌握，出了问题更容易看清文件到底装到哪了。

推荐安装方式

方式一：用 skills add 安装

仓库 README 推荐的安装命令是这一句：

npx skills add https://github.com/Nanzheng-SC/html-ppt-editable-skill

适合已经配置好 skills CLI 的环境。执行完成后，重点不是看终端有没有一句“成功”，而是去 skills 目录里确认 SKILL.md、assets/、templates/、references/ 这些内容真的在。

方式二：手动 clone 到 Codex skills 目录

如果你想更可控，直接手动 clone：

mkdir -p ~/.codex/skills
git clone https://github.com/Nanzheng-SC/html-ppt-editable-skill.git ~/.codex/skills/html-ppt-editable

目录名建议保持 html-ppt-editable。别随手改成 ppt-test、new-skill 这种名字，后面你自己排查触发问题时会很绕。名字清楚，少给自己挖坑。

装好后先做这几个验证

先确认 Skill 入口文件存在：

ls ~/.codex/skills/html-ppt-editable/SKILL.md

再看核心资源目录是不是完整：

ls ~/.codex/skills/html-ppt-editable/assets
ls ~/.codex/skills/html-ppt-editable/templates
ls ~/.codex/skills/html-ppt-editable/references

这个仓库不是只有一个提示词文件。README 里列了 36 套主题、15 套完整 deck 模板、31 个单页布局、20 个 Canvas FX、4 个 showcase deck，还有 assets/editable-runtime.js 这个可编辑运行时。少了这些目录，就算 SKILL.md 在，也很可能生成不出完整效果。

跑一个最小测试

安装完成后，在 Codex 或兼容 Agent 里直接点名调用，别让它猜：

请使用 html-ppt-editable 做一份 5 页中文技术分享 slides，主题是“AI 工程化落地复盘”，需要浏览器内联编辑能力和 speaker notes。

如果它正常生效，输出应该是一个可打开的 HTML deck，而不是纯 Markdown 大纲。打开后试一下方向键翻页、按 E 进入编辑、改一行标题、再按 Ctrl+S 或 Cmd+S 保存。这个步骤别省。很多问题只有到浏览器里才露出来。

我建议顺手补的两个实操检查

检查编辑 runtime 是否被引用

SKILL.md 里要求生成的 deck 底部保留两个脚本：普通演示 runtime 和可编辑 runtime。如果少了后者，页面能翻页，但按 E 没反应。

<script src="../assets/runtime.js"></script>
<script src="../assets/editable-runtime.js"></script>

嵌套目录越深，路径越容易错。这里我就踩过一次，页面能打开，但编辑按钮不出来。查到后才发现是 ../ 少了一层，挺烦的。

浏览器保存不是改回原模板

这个点很容易误解。浏览器里的自动保存会先写进 localStorage，显式保存时导出一份包含修改内容的新 HTML。它不是直接回写 templates/deck-editable.html。我一开始也下意识去模板里找改动，结果当然找不到。

常见故障排查

现象	常见原因	处理办法
Agent 没触发 html-ppt-editable	Skill 装错目录，或者提示词没有明确点名。	确认 ~/.codex/skills/html-ppt-editable/SKILL.md 存在，并在需求里写“使用 html-ppt-editable”。
页面能打开，但按 E 不能编辑	assets/editable-runtime.js 没被引用，或相对路径写错。	检查生成 HTML 底部是否同时加载 runtime.js 和 editable-runtime.js。
编辑后刷新又变回旧内容	本地草稿键变化、浏览器隐私模式、或没有显式保存。	改完后用 Ctrl+S / Cmd+S 导出完整 HTML，不要只依赖临时草稿。
演讲者模式里也出现编辑控件	生成文件改动过 runtime 初始化逻辑。	按仓库约定保留原版 editable-runtime.js；它会跳过 ?preview=N iframe。
生成效果太像空模板	Agent 没选合适模板，或者需求里没有场景和页数。	明确写“技术分享 / pitch deck / 小红书轮播 / 课程课件”，并给出页数、语言和风格。

多 Skill 环境再多加一句话

如果你的 skills 目录里同时有 html-ppt-skill、frontend-slides、别的 PPT 生成 Skill，建议每次开头直接写明：

请优先使用 html-ppt-editable，不要调用其他 PPT 或 slides Skill。

这句看着啰嗦，但能减少路由误判。否则 Agent 有时会生成一份好看的静态 HTML，却忘了加内联编辑能力。

批量生成指令模板

如果你要一次做多份 deck，建议把任务写成清单。别一句“帮我做几份 PPT”就丢过去，生成结果很容易飘。

请使用 html-ppt-editable 连续生成 3 份可编辑 HTML slides。

统一要求：
- 每份都保留浏览器内联编辑能力
- 每份都带 speaker notes
- 使用中文
- 页面可以用方向键翻页
- 输出时说明每份 HTML 文件路径

任务清单：
1. 主题：AI 工程化落地复盘；类型：技术分享；页数：8 页
2. 主题：跨境电商新品融资计划；类型：pitch deck；页数：10 页
3. 主题：Python 入门小课；类型：课程课件；页数：6 页

这里的关键是“类型”和“页数”写清楚。这个 Skill 有模板库，任务越明确，越容易选到合适的 full-deck 或 single-page layout。

适合和不适合的场景

它适合做静态 HTML 演示、浏览器预览、讲稿辅助、生成后手动微调文字。尤其是周报、技术分享、课程课件这种后期经常改字的内容，用起来很舒服。

但它不是传统 PowerPoint 插件，也不是“生成原生可编辑 PPTX”的工具。如果你的最终交付必须是 PowerPoint 里每个文本框、图形、表格都能原生编辑，那要另外走 HTML 转 PPTX 或专门的 PPTX 生成链路。别把两个目标混在一起，不然后面会很拧巴。

安装完成后的收尾确认

到这里，安装流程基本就走完了。我平时会快速看几个节点：SKILL.md 在正确目录，assets/ 和 templates/ 没缺，Agent 能识别 html-ppt-editable，生成的 HTML 能翻页，按 E 可以直接编辑文字，Ctrl+S 或 Cmd+S 能导出修改后的完整 HTML。

这些都能跑通，就说明 Nanzheng-SC/html-ppt-editable-skill 已经可以稳定使用。后面真正提需求时，把“可编辑 HTML slides”“页数”“场景类型”“是否需要 speaker notes”说清楚，出片会稳很多。