跳转到使用指南
pptx-generator作者 MiniMax

PPTX Generator Skill.

一个 Claude Code 和 Codex skill,用于 PPT 和幻灯片:生成、编辑和读取可编辑的 PowerPoint 演示文稿。

  • Presentations
  • PPTX
MiniMax-AI/skills · skills/pptx-generator/SKILL.mdSKILL.md
--- name: pptx-generator description: Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides. --- ## Creating from Scratch — Workflow ## Slide Output Format ## Theme Object Contract (MANDATORY) ## Page Number Badge (REQUIRED) ## Dependencies
前置信息和章节标题读取自上游文件,时间为 2026-09-14 · 完整内容 7,882 字符

01 功能说明

pptx-generator Skill 在 Claude Code 和 Codex 中的功能

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

覆盖编程 Agent 所需的整个 PowerPoint 场景:用 markitdown 读取现有演示文稿的文本、通过 XML 工作流编辑基于模板的演示文稿,以及用 PptxGenJS 从零构建演示文稿。

从零开始的路径是一个七步工作流——收集需求、选定配色方案与字体搭配、选择 Sharp、Soft、Rounded 或 Pill 风格、将每一页归类为五种页面类型之一、为每一页生成一个同步 JS 模块、通过 slides/compile.js 编译,最后运行必需的 QA 检查。一份包含五个精确 key 的强制主题契约保证各页一致,画布尺寸为 10 x 5.625 英寸,除封面外每一页都带有页码徽标。

它产出什么

  • 每页对应一个完整、可运行的 JS 文件,各自导出 createSlide 和 slideConfig。
  • 一个 slides/compile.js 脚本,会引入每个幻灯片模块并写出组装完成的演示文稿。
  • 位于 slides/output/ 的最终成品演示文稿。
  • 单页预览用的 PPTX,当某个模块单独运行时,会以该幻灯片专属的文件名写出。
查看示例提示词 ↗

工作方式

  1. 01
    先读取源演示文稿

    当已有演示文稿存在时,先提取其文本,再动手处理布局,这样 Agent 依据的是真实内容,而不是猜测。

  2. 02
    选择配色、字体和设计风格

    设计系统参考资料提供配色方案、字体搭配、风格方案(Sharp、Soft、Rounded、Pill)以及排版间距,均根据主题和受众选定。

  3. 03
    按页面类型规划大纲

    每一页都必须被归类为五种页面类型中的恰好一种,并按页规划内容与布局,避免布局重复。

  4. 04
    为每页撰写一个 JS 模块

    幻灯片文件位于 slides 目录中,各自导出一个同步的 createSlide(pres, theme) 函数;最多可将五个分配给子 Agent 处理。

  5. 05
    将各模块编译成一份完整演示文稿

    一个编译脚本会引入每个幻灯片模块,应用共享的主题对象,并写出最终文件。

  6. 06
    运行必需的 QA 检查

    工作流的第 7 步是强制性的,会指向 QA 流程和 PptxGenJS 常见问题检查清单。

02 找到适合场景

何时使用 pptx-generator Skill

当任务是此类 PPT 和幻灯片时,在 Claude Code 或 Codex 中使用 pptx-generator skill。适用范围和限制取自 skill 自己的文件。

适合场景

  • 任何以 PPT、PPTX、PowerPoint、presentation、slide、deck 或 slides 等词表述的请求,都是该 skill 声明的触发条件。
  • 阅读或分析现有演示文稿中已有的内容,而不是重新构建它。
  • 编辑基于模板的演示文稿,同时保持其现有 XML 格式不变。
  • 在没有任何可作为起点的素材时,使用 PptxGenJS 从代码构建一份有设计感的演示文稿。

了解边界

  • 从零开始的工作流仅适用于没有模板或参考演示文稿的情况;若手头已有模板,则应改用编辑路径。
  • 绘图仅限于四种形状基元:矩形、椭圆、直线和圆角矩形。
  • 图表仅限于列出的七种类型,因此更特殊的图表形式不在已记录的范围内。

需要提供的信息

  • 需求 brief第 1 步要求 Agent 研究主题、受众、目的、语气和内容深度,因此最清晰的输入就是对这些要点的简要说明。
  • 机器上可用的 PptxGenJS从零开始创建演示文稿需要全局安装 pptxgenjs 包。
  • 支持 pptx 的 markitdown从现有演示文稿中提取文本,取决于是否安装了 markitdown 的 pptx 附加组件。
  • 可选的图标包幻灯片中的图标仅在安装了 react-icons、react、react-dom 和 sharp 时才能生效;文件将其标注为可选项。

03 Skill 内部

pptx-generator skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 只使用五个主题 key,不能多也不能少

    编译脚本仅传入 primary、secondary、accent、light 和 bg。其他名称如 background、text、muted、darkest 或 lightest 均被明确禁止。

  2. 除封面外,每张幻灯片都要有徽标

    右下角的页码徽标在除封面页之外的所有幻灯片上都是必需的。

  3. 仅显示幻灯片编号本身

    徽标只显示当前编号,例如 3 或 03,而不显示形如 3/12 的总数比例。

  4. 保持 16:9 画布比例

    幻灯片尺寸为 10 x 5.625 英寸,使用 LAYOUT_16x9,编译脚本将其设为演示文稿的布局。

  5. 以裸十六进制格式书写颜色

    颜色为不带前导井号的 6 位十六进制字符串,例如 "FF0000"。

  6. 保持 createSlide 为同步函数

    每个幻灯片模块导出一个同步的 createSlide(pres, theme) 函数;不接受异步的幻灯片函数。

  7. 变换布局

    规划时必须刻意避免在整个演示文稿中重复使用相同的幻灯片布局。

  8. 并发上限为五张幻灯片

    当子 Agent 可用时,最多可并发生成 5 张幻灯片。

04 投入使用

在 Claude Code 或 Codex 中安装 pptx-generator

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 pptx-generator 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/MiniMax-AI/skills --skill pptx-generator

用于 skills/pptx-generator/SKILL.md 的通用 skills CLI 格式;该仓库可能会记录其自身的路径。

为 Skill 提供首个 PPT 和幻灯片任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Build a 12-slide deck on [topic] for [audience]. Open with a cover slide, add a table of contents and two section dividers, and keep the layouts varied across the content slides. Use a Soft style with a muted palette and Arial for the English text, and put the page number badge on every slide except the cover.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 按照 pitfalls.md 中的说明走一遍 QA 流程,其中涵盖了常见错误和关键的 PptxGenJS 陷阱。
  • 在编译整份文件之前,单独运行某个幻灯片模块,生成一个以该幻灯片专属文件名命名的预览 PPTX。
  • 确认页码徽标位于右下角 x: 9.3"、y: 5.1" 处。
  • 在做模板相关的工作时,对照编辑工作流的格式规则以及其常见陷阱列表来核对结果。

在 OpenDesign 中pptx-generator 已内置:在顶部栏的 Plugins → Skills 中选择它即可。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
MiniMax
Repository
github.com/MiniMax-AI/skills 分支 main
Skill 文件
skills/pptx-generator/SKILL.md 验证时记录的内容校验和;提交 60aaae5
License
MIT 来自 LICENSE;SKILL.md 中注明「MIT」。
仓库星标数
13,547 GitHub 快照拍摄于 2026-09-14,针对整个 MiniMax-AI/skills 仓库,该仓库在此目录中包含 6 个 skills。不是 pptx-generator 的评分或使用次数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可证文本和星标数。已捆绑在 OpenDesign 主版本中(检查于 2026-08-28);此页面尚未记录实际运行。

SKILL.md 内部

  1. 概览范围:读取演示文稿、通过 XML 编辑模板,或使用设计系统从零构建演示文稿。
  2. 快速参考任务到方法的对照表,以及尺寸、颜色、字体、徽标位置、主题键、形状、图表等信息。
  3. 参考文件映射五个配套文件:幻灯片类型、设计系统、编辑、常见陷阱、PptxGenJS API。
  4. 读取内容用一条 markitdown 命令从现有演示文稿中提取文本。
  5. 从零创建——工作流七个步骤:需求、配色、样式、大纲、幻灯片模块、编译、QA。
  6. 幻灯片输出格式幻灯片文件的结构:配置对象、同步的 createSlide、独立的预览代码块。
  7. 主题对象约定(强制)固定五个主题键,并禁止使用诸如 background 或 text 之类的替代名称。
  8. 页码徽标(必需)徽标规则及圆形和药丸形变体在固定位置的代码。
  9. 依赖项markitdown、pptxgenjs 以及可选图标包的安装命令。
Skill 自身的描述
"生成、编辑和读取 PowerPoint 演示文稿。使用 PptxGenJS 从头创建(封面、目录、内容、章节分隔页、总结幻灯片),通过 XML 工作流编辑现有 PPTX,或使用 markitdown 提取文本。触发词:PPT、PPTX、PowerPoint、presentation、slide、deck、slides。"

来自 SKILL.md 的前置描述。完整文件大约 7,882 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 pptx-generator Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

它能编辑我已有的演示文稿,还是只能新建?

两者都可以。编辑现有演示文稿以及基于模板创建都通过一个单独的工作流完成,该工作流记录在编辑参考中,涵盖 XML 操作、格式规则和常见陷阱。

它能生成哪些类型的幻灯片?

文档中记录了五种页面类型:封面、目录、章节分隔页、内容页和总结页,此外幻灯片类型参考中还有更多布局模式。

它编写的代码有没有 API 参考?

有。幻灯片模块应遵循 PptxGenJS 参考文件,该目录将其描述为一份完整的 API 参考。

PPTX Generator

在真实的 PPT 和幻灯片任务上运行 pptx-generator。

pptx-generator skill 内置于 OpenDesign 中。下载应用,在 Plugins → Skills 中选择该 skill,粘贴上述提示词,并在查看结果之前阅读计划。

终端
npx skills add https://github.com/MiniMax-AI/skills --skill pptx-generator