效率与协作 pptx-generationhtml-to-pptxpptxgenjsplaywrightthumbnail-renderingooxml-validationlibreoffice

PPTX 转换技能

把 HTML 幻灯片可靠地转换成 PowerPoint(PPTX)文件,并提供编辑与缩略图预览能力,适合以 HTML 为源的自动化演示生成流程。

FollowSkills 评估 · FSRS-2.0
谨慎使用
52/ 100 五分制 2.6 / 5
1 2 3 4 5 6
1信任安全15 / 25 · 3.0/5

脚本均为本地文件处理(HTML转PPTX、打包/解包、缩略图),未见网络外传、凭证访问或破坏性默认行为;打包在临时目录操作并校验。扣分项:依赖链较重(Playwright浏览器、LibreOffice、sharp),无显式权限/确认机制说明,发布者身份未验证,无来源归属声明。

2可靠稳定10 / 20 · 2.5/5

文档自洽且详细(尺寸校验、溢出检测、颜色#前缀规则、错误聚合报告),脚本含输入校验与可诊断错误信息。扣分项:静态审查未执行,无测试套件或CI证据覆盖关键路径;html2pptx.js被截断不完整;html2pptx.md声称依赖'已全局安装'假设未验证;validate.py依赖未在文件中提供的validation模块。

3适用触发9 / 15 · 3.0/5

场景清晰(HTML幻灯片转PPTX/编辑/缩略图),能力边界明确(仅支持的HTML元素、字体限制、渐变限制),触发描述明确。扣分项:文档为韩文/英文,无中文支持声明;核心依赖Playwright需下载浏览器、LibreOffice等,在中国大陆网络环境可达性与安装成本未说明。

4规范维护8 / 15 · 2.7/5

信息架构分层良好(SKILL.md→详细指南→OOXML参考),注意事项与已知限制披露充分。扣分项:技能级许可元数据未知(仅README称MIT),无版本号/变更日志,维护责任与更新路径不明确,README中的克隆URL为占位符(YOUR_USERNAME),安装说明与技能实际依赖不完全对应。

5有效结果6 / 15 · 2.0/5

声称完成HTML→PPTX转换这一核心任务,内置校验与缩略图验证流程设计合理,相比手工制作PPTX有边际价值。扣分项:静态审查无法验证输出可直接使用,无代表性产出证据,效果声明主要来自作者文档,比较优势未经验证。

6证据核验4 / 10 · 2.0/5

提供了可审计的一手材料(完整脚本、详细API文档、XML参考),可部分复核逻辑。扣分项:无第三方执行证据、无测试、无CI覆盖该技能关键路径,关键声明(转换质量、依赖可用性)仅来自作者自述。

证据充分度: 评估于 2026年9月10日 审查版本 cfe7781859de
使用前请注意
  • 依赖较重:需安装 Playwright 浏览器、LibreOffice、Poppler、sharp 等,部署成本高,且在中国大陆网络的下载可达性未经验证,请提前准备镜像或离线安装方案。
  • 未执行验证:本评估为静态源码审查,转换质量与脚本完整性(html2pptx.js 文件不完整)未经实际运行确认,使用前请先以样例幻灯片测试。
  • 文档为韩文/英文,无中文支持;技能级许可元数据缺失,商用前请核实仓库 MIT 许可的适用性。
  • validate.py 依赖的 validation 模块未在审查文件中出现,运行前请确认模块存在于仓库中。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是一个 Claude Code 技能,核心功能是把 720pt × 405pt(16:9)规格的 HTML 幻灯片转换成 PPTX 文件。它调用 Node.js 脚本 html2pptx.js(基于 Playwright 渲染和 PptxGenJS 生成),并附带缩略图生成、OOXML 打包/解包与结构校验等 Python 辅助脚本。技能文档还包含 PptxGenJS 的关键规则(如颜色代码不能带 # 号)和文字、图片、形状、图表的代码示例。安装前需要 Node.js、Python、LibreOffice 和 Poppler 等系统依赖。仓库为多技能合集,本页仅描述其中 .claude/skills/pptx-skill/ 下的这一个。

读取 slides/ 目录下符合 16:9 规格的 HTML 幻灯片文件,通过 Playwright 渲染并经 PptxGenJS 输出 PPTX;支持用 thumbnail.py 生成预览缩略图网格(可选列数与占位符轮廓);用 unpack.py/pack.py 解包与重新打包 PPTX 的 OOXML 内容;用 validate.py 校验解包后的结构;另附编辑现有演示文稿的能力说明与 html2pptx、ooxml 详细参考文档。

  1. 需要批量产出 16:9 演示文稿的内容团队,已在 HTML 中设计好版式,希望自动转成可编辑的 PPTX 文件
  2. 使用 Claude Code 的开发者想让 AI 代理在自动化流水线中生成并验证 PowerPoint 交付物
  3. 需要为已生成的 PPTX 制作缩略图预览网格以便人工审核的审稿流程
  4. 需要深入检查或修补 PPTX 文件内部 OOXML 结构的文档工程师
  5. 在 CI 或脚本环境中需要 HTML→PPTX 转换命令行工具的工程团队

这个 Skill 有哪些优点和局限?

优点
  • 转换、缩略图、解包、校验形成完整的生成—验证闭环,可自动化质检
  • 文档详细,含 PptxGenJS 用法规则和常见坑(如颜色不能带 #)
  • 基于成熟的 PptxGenJS 和 Playwright,输出真正的 PPTX 而非截图式幻灯片
  • 附带 OOXML 级别的解包/打包/校验工具,可深度修复文件
局限
  • 依赖较重:需要 Node.js、多个 Python 包、LibreOffice 和 Poppler,安装门槛高
  • HTML 支持有限:仅 p、h1-h6、ul、ol 标签可转换,CSS 渐变会被替换成图片
  • 仅支持 Web 安全字体,字体替换风险需自行评估
  • README 未提供许可证字段,仓库元数据中许可证不明(README 正文声称 MIT,但与 GitHub 元数据不一致,未验证)
  • 无可见测试套件或平台兼容性说明;缩略图质量依赖 LibreOffice 渲染效果

如何安装这个 Skill?

源文档未给出该技能单独的安装步骤。README 描述整个仓库的安装:克隆 https://github.com/uxjoseph/ppt_team_agent,进入目录后运行 npm install,要求 Node.js v16 及以上。技能文件位于 .claude/skills/pptx-skill/SKILL.md,Claude Code 项目会自动识别该路径。另需系统级依赖:Python 包(markitdown、defusedxml、pillow)、LibreOffice 和 Poppler(README 未提及这些的安装命令)。

如何使用这个 Skill?

1) 将各幻灯片 HTML 放入 slides/ 目录并确认每页为 720pt × 405pt(16:9)。2) 运行 node .claude/skills/pptx-skill/scripts/html2pptx.js 生成 PPTX,或在代码中导入 html2pptx 函数逐页转换后用 pres.writeFile 保存。3) 用 python .claude/skills/pptx-skill/scripts/thumbnail.py presentation.pptx output-thumbnail(可加 --cols N 或 --outline-placeholders)生成缩略图做视觉校验。4) 如需修改文件内部,用 ooxml/scripts/unpack.py 解包、validate.py 校验、pack.py 重新打包。文档未给出触发该技能的具体对话提示语。

常见问题

转换后我得到的是可编辑的 PPTX 吗?
是的。该技能使用 PptxGenJS 生成原生 PowerPoint 对象(文本、图片、形状、图表),而不是把页面截图贴进幻灯片,因此产物在 PowerPoint 中可编辑。
什么样的 HTML 能被正确转换?
每页需为 720pt × 405pt(16:9);只支持 p、h1-h6、ul、ol 标签,字体须为 Web 安全字体,CSS 渐变会作为图片处理。转换后务必用缩略图检查。
部署前需要装哪些系统依赖?
Node.js v16+(含 pptxgenjs、playwright、sharp)、Python 包(markitdown、defusedxml、pillow)、LibreOffice(soffice)和 Poppler(pdftoppm)。缺少 LibreOffice 或 Poppler 时缩略图/PDF 相关功能会失效。
这个仓库里还有别的技能,和这个是同一个吗?
不是。该仓库打包了多个技能,本页仅描述 .claude/skills/pptx-skill/SKILL.md 这一个;仓库中其他技能的能力不在本页范围内。

同仓库的其他 Skills

均来自 uxjoseph/ppt_team_agent

相关 Skills