pptx

pptx skill 概览

pptx skill 适合用来做什么

pptx skill 可帮助 Claude 创建、编辑、检查和修复 PowerPoint .pptx 演示文稿。它基于一个现实前提：PowerPoint 文件本质上是由 Office Open XML 文件组成的 ZIP 包。因此，它既能支持较高层级的演示文稿工作流，也能在普通文本提取不够用时，深入到底层 XML 进行检查。

最适合的用户和 PowerPoint 任务

如果你希望 Claude 直接处理 slide deck，而不只是帮你写幻灯片文案，这个 skill 会很适合。常见任务包括提取结构化幻灯片内容、编辑现有 deck、重新排列幻灯片、在保留格式的前提下替换文本、添加 speaker notes 或 comments，以及基于类似 HTML 的幻灯片布局生成新 deck。对于需要维护模板、销售 deck、培训 deck 或周期性报告的团队，它尤其有用。

这个 pptx skill 的不同之处

和泛泛地让模型“处理 PowerPoint”的 prompt 不同，这个 repository 提供了实用的辅助脚本和技术参考：用于结构化提取的 scripts/inventory.py、用于文本替换的 scripts/replace.py、用于幻灯片排序的 scripts/rearrange.py、用于预览的 scripts/thumbnail.py、用于 HTML-to-PowerPoint 生成的 scripts/html2pptx.js，以及说明原始 XML 规则的 ooxml.md。这些内容让 agent 从“编辑这个 deck”走到实际的文件级修改时，有更可靠的路径。

采用前需要注意的事项

pptx skill 比简单的写作助手更偏技术型。有些工作流依赖 python-pptx、Pillow 等 Python packages；HTML 转换则会使用 pptxgenjs、playwright、sharp 等 Node.js libraries。底层编辑需要格外谨慎，因为无效的 XML relationships、错误的 element ordering，或损坏的 image references，都可能导致 .pptx 无法打开。

如何使用 pptx skill

pptx skill 的安装方式和优先阅读的 repository 文件

在 skill directory context 中使用以下命令安装：

npx skills add ComposioHQ/awesome-claude-skills --skill pptx

安装后，先阅读 SKILL.md 了解主工作流。如果你计划从 HTML 生成 deck，再读 html2pptx.md；如果你需要处理 comments、speaker notes、layouts、images，或其他需要访问原始 XML 的功能，则应阅读 ooxml.md。脚本方面，建议查看 scripts/inventory.py、scripts/replace.py、scripts/rearrange.py、scripts/html2pptx.js 和 ooxml/scripts/unpack.py。

pptx skill 需要哪些输入

用于分析时，请提供 .pptx 文件，并说明你需要的是 plain text、structured JSON、visual slide order、notes、comments，还是 layout details。用于编辑时，请提供 source deck、目标 output deck name、replacement rules、slide order、brand constraints，以及任何绝不能改动的文本。用于创建新 deck 时，请提供 slide dimensions、audience、tone、逐页内容、image assets，并说明你希望得到可编辑的 PowerPoint objects，还是更接近截图效果的 fidelity。

更有效的 pptx 使用 prompt 写法

较弱的 prompt 是：“Update this PowerPoint.” 更好的 prompt 是：

“Use the pptx skill to inspect Q3-review.pptx, extract a slide inventory, then replace only customer names and revenue figures using replacements.json. Preserve existing fonts, bullets, alignment, and slide order. Save as Q3-review-redacted.pptx and report any shapes that could not be edited safely.”

用于生成时：

“Create a 16:9 PowerPoint from HTML slides. Use 720pt x 405pt body dimensions, put all text inside <p>, heading, <ul>, or <ol> tags, avoid manual bullet symbols, and reserve chart areas with class="placeholder" so charts can be added later.”

获得稳定输出的实用工作流

如果只是简单读取内容，先转换或提取文本，再考虑 XML 编辑。对于全 deck 的文本修改，先运行 inventory，审核生成的 JSON，再应用 replacements，不要直接要求盲改。重新排列幻灯片时，使用从 0 开始的 slide indices，并确认重复出现的幻灯片确实是有意保留。遇到复杂格式时，应先解包 .pptx，检查 ppt/presentation.xml、ppt/slides/slideN.xml、slide relationships、notes 和 layouts，再把修改写回文件。

pptx skill 常见问题

pptx skill 是用来创建 PowerPoint，还是编辑 PowerPoint？

两者都可以。pptx skill 可支持创建新 deck、编辑现有 deck、分析幻灯片、提取文本、重新排列幻灯片，以及更底层的 PowerPoint XML 处理。它的最大价值通常体现在任务涉及真实 .pptx 文件时，而不只是起草幻灯片标题和 bullet points。

什么时候应该使用原始 XML，而不是普通提取？

当你需要 speaker notes、comments、slide layouts、relationships、animations、images、详细 formatting，或任何基础文本提取无法呈现的内容时，应使用原始 XML。Plain text extraction 更适合快速总结，但会遗漏很多在正式生产 deck 中很重要的结构。

这份 pptx 指南适合新手吗？

如果任务只限于提取、替换或调整幻灯片顺序，新手也可以使用。更高级的工作流需要熟悉 command-line tools、JSON、Python scripts、Node.js packages 和 Office Open XML。如果你只是需要幻灯片文案，普通写作 prompt 可能更简单。

什么时候不应该使用这个 skill？

如果你需要无需审核即可保证 pixel-perfect 的设计效果，无法安装所需依赖，或演示文稿包含高度复杂且绝不能被改动的专有 layouts，就不适合使用它。此外，在将材料用于预期 Anthropic services context 之外的场景前，也应先查看 LICENSE.txt。

如何改进 pptx skill 的使用效果

用更完整的源上下文提升 pptx skill 结果

给这个 skill 提供具体文件和约束：source .pptx、target output name、slide numbers、replacement data、brand rules、required fonts、aspect ratio、image paths，以及 formatting 是需要保留还是重新设计。你越清楚地区分“内容可以变”和“layout 必须固定”，输出就越安全。

避免常见的 PowerPoint 失败模式

大多数失败来自模糊的编辑指令、不受支持的 HTML structure、错误的 slide dimensions、损坏的 relationships，或无效的 XML ordering。处理 HTML-to-PowerPoint 时，应把文本放在支持的 text tags 中，使用真正的 lists 而不是手动 bullet 符号，让 body dimensions 与 PowerPoint layout 匹配，并在导出前检查是否有 overflow。

首次输出后继续迭代

当准确性很重要时，在最终编辑前先要求生成 inventory 或 thumbnail pass。生成或修改 deck 后，用 PowerPoint 或 LibreOffice 打开文件，检查 slide count、missing images、bullet formatting、speaker notes 和 chart placeholders，然后让 agent 按具体 slide numbers 修复问题，而不是把所有内容全部重新生成。

为团队工作流扩展 pptx skill

如果会反复使用，可以补充 template-specific notes：approved layouts、placeholder names、chart conventions、required slide masters，以及 forbidden edits。你也可以维护标准的 replacement JSON examples、preferred slide sequences 和 validation checks，让 pptx skill 在季度报告、pitch decks 和本地化 PowerPoint 版本中保持一致表现。