前言¶
在 Cursor、Claude Code 等环境里，用户常说「帮我做一个关于 XX 的 PPT」。模型若只输出大纲或 Markdown，仍需人工套版、导出，链路长且版式不稳定。若希望 Agent 直接交付可在 PowerPoint、WPS 中打开的 .pptx，需要一套可复用的流程：规划页型、写结构化内容、用脚本渲染。
下面介绍 SkillHub 社区技能 ppt创作之神（坐标 @user_65e10e1c/ppt-creater）。它把「需求理解 → 幻灯片结构 → JSON 内容定义 → python-pptx 生成」写进 SKILL.md，并附带生成脚本与版式参考，适合在支持 Agent Skills 的客户端里按需安装启用。
这是什么¶
ppt创作之神 是面向「从零创建演示文稿」的 Agent Skill，当前版本 1.0.0，来源为 SkillHub community，分类 office-efficiency，发布者为 user_65e10e1c（SkillHub 页面标注作者为浩然）。SkillHub 简介为「自由创作 ppt 的利器」；技能元数据说明其应在用户要求创建、生成或制作 PPT、PowerPoint、演示文稿、幻灯片等场景下启用。
标签 requires_api_key=false，不依赖额外 API Key。在 SkillHub 上该技能评分 100000，下载 1427 次（以平台展示为准，会随时间变化）。
官方入口：
- 技能页：https://www.skillhub.cn/skills/user_65e10e1c/ppt-creater
- API 坐标：https://api.skillhub.cn/user_65e10e1c/ppt-creater
核心功能¶
经 skillhub search 与安装包内 SKILL.md 核对，该技能具备以下能力（均围绕 python-pptx 输出原生 .pptx）：
- 从零生成演示文稿：根据主题或大纲规划幻灯片结构，再生成文件。
- 五种配色主题：
default、dark、warm、green、minimal（文档中对应默认蓝、深色、暖色、绿色、极简等场景说明）。 - 七种页型：
title（封面）、section（章节分隔）、content（要点）、two_column（双栏对比）、quote（引用）、table（表格）、closing（致谢/收尾）。 - 版式与中文：支持 16:9 与 4:3 宽高比；中文演示默认使用「微软雅黑」；可为内容页添加演讲者备注（
notes字段）。 - 内容与渲染分离：Agent 先写 JSON 内容定义，再调用
scripts/create_pptx.py生成.pptx；修改时建议改 JSON 后重新运行脚本。 - 内置参考文档：
references/design_guidelines.md（结构模板、页数建议、设计原则）、references/slide_types.md（各页型 JSON 字段与示例）。
常见触发表述包括：「帮我做一个PPT」「创建演示文稿」「生成幻灯片」、make a presentation、create slides 等。
安装与启用¶
安装前需本机有 skillhub CLI。若未安装，可按 SkillHub 官方说明执行（完整安装含 CLI 与默认 Skill）：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装技能时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被客户端加载。SkillHub 文档给出的常见路径如下：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装 ppt创作之神 的命令（与 skillhub search 输出一致）：
skillhub install ppt-creater --namespace user_65e10e1c --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent skills 路径即可。安装完成后，按所用客户端要求重启或刷新 Agent，使技能被索引。
运行生成脚本前，当前 Python 环境需已安装 python-pptx：
python3 -m pip install python-pptx
典型用法¶
技能文档定义的标准工作流如下，可在对话中由 Agent 自动执行，也可对照手动复现。
1、澄清需求¶
向 Agent 说明主题；可选补充听众、大致页数、主题色偏好、16:9 或 4:3。若只给主题，默认常按约 8–12 页、default 主题、16:9 处理。
2、规划幻灯片结构¶
结合 references/design_guidelines.md 选择商务汇报、产品介绍、学术、培训等结构模板，并混用 content、table、two_column、quote 等页型。
3、编写 JSON 内容定义¶
将完整定义写入临时 JSON 文件。最小结构示例（字段含义见 references/slide_types.md）：
{
"theme": "default",
"aspect_ratio": "16:9",
"slides": [
{"type": "title", "title": "季度业务回顾", "subtitle": "2026 Q3"},
{"type": "section", "title": "核心指标"},
{
"type": "content",
"title": "增长亮点",
"bullets": ["营收同比提升", {"text": "新客户占比", "level": 1}],
"notes": "此处展开口头说明"
},
{"type": "closing", "title": "谢谢", "subtitle": "Q&A"}
]
}
4、调用脚本生成 .pptx¶
在技能安装目录下执行（将路径替换为你的实际路径）：
python3 ~/.cursor/skills/@user_65e10e1c/ppt-creater/scripts/create_pptx.py \
/path/to/content.json \
/path/to/output.pptx
脚本用法为：python create_pptx.py <content_json_path> <output_pptx_path>。生成后由 Agent 将文件交给用户，并简要说明主题、页数与章节结构。
也可直接向 Agent 发送自然语言请求，例如：「用 default 主题、16:9，帮我做一个 10 页左右、关于团队 OKR 复盘的中文 PPT，生成 pptx。」Agent 在加载本技能后应按上述流程产出 JSON 并运行脚本。
适用场景与注意¶
适合：需要快速得到可编辑 .pptx、内容以要点/表格/双栏为主、接受 Agent 按 JSON 模板排版的场景；中文汇报、内部分享、培训提纲等。
限制与注意：
- 输出质量依赖 Agent 写 JSON 的内容与结构规划，复杂动画、母版级定制不在技能描述范围内。
SKILL.md中部分示例使用特定客户端的 Python 绝对路径；在 Cursor 等环境应改用本机python3与技能实际安装目录。- 表格建议控制在文档建议的规模（约 5–8 行、最多 5 列），要点宜短，便于版面可读。
- 封面与封底不自动加页码，其余页由脚本添加页码。
- 修改已生成文件时，优先改 JSON 再重新生成，比直接手改
.pptx更易与 Agent 协作。
结尾¶
ppt创作之神 把演示文稿创作收敛为「结构化 JSON + python-pptx 脚本」的固定链路，适合已在使用 SkillHub 与 Agent Skills 的开发者或办公场景。安装与详情见 SkillHub 技能页：https://www.skillhub.cn/skills/user_65e10e1c/ppt-creater ；API 坐标：https://api.skillhub.cn/user_65e10e1c/ppt-creater 。
