乐于分享
好东西不私藏

【宝藏技能推荐 第一期】一个让AI原生生成PPT的技能树:guizang-ppt-skill不完全手册

【宝藏技能推荐 第一期】一个让AI原生生成PPT的技能树:guizang-ppt-skill不完全手册

如果你是 AI Agent 重度用户,可能有过这样的经历:让 AI 帮你写一份 PPT,它给你吐出一份 Markdown,再花大量时间改格式——来回好几次,最后发现还不如手动做。

guizang-ppt-skill 就是来解决这个问题的。

这是一个专为 Claude Code / Codex 等 AI Agent 环境设计的 HTML PPT 生成技能,核心理念是:让 AI 直接生成可交付的单文件 HTML 横向翻页 PPT,而不是让它帮你"写 PPT 文字内容然后你自己去排版"。

作者是 @歸藏[1],曾在"一人公司:被 AI 折叠的组织"等多场线下分享中实际使用并持续迭代,踩过的坑都写进了技能的检查清单。


这个技能的核心能力

🎨 双视觉系统

技能内置两套风格完全不同的视觉语言:

Style A · 电子杂志 × 电子墨水

参考 Monocle 杂志版式,强调叙事感、个人风格表达,适合观点分享、行业演讲、私享会等场景。

内置 10 种页面布局:封面、章节、数据大字报、图文、图片网格、Pipeline、对比等。

5 套预设主题色:墨水经典、靛蓝瓷、森林墨、牛皮纸、沙丘。

Style B · 瑞士国际主义

网格至上、单一高饱和锚点色、直角、发丝线、极致字号对比,适合事实、产品、分析、方法论等更偏"信息密度"容。

22 个具名版式(S01 ~ S22),正文页只能从这 22 种里选,不能临时发明页面结构

4 套锚点色:克莱因蓝 IKB、柠檬黄、柠檬绿、安全橙。

Style B 还自带版式校验脚本,用 Node.js 跑一下就能检查页面有没有乱用版式、居中标题、危险 SVG 等 P0 级问题。


📐 生成什么?

交付物
说明
单文件 HTML 横向翻页 PPT
键盘 ← → / 滚轮 / 触屏滑动 / 底部圆点 / ESC 索引,浏览器直接打开
PPT 配图
在 Codex 中用 GPT-Image 2.0 / GPT-M 2.0 生成纪实照片、信息图、流程图、UI 情景图,按模板比例插入
多平台封面
同一套视觉规则生成公众号 21:9 头图、1:1 分享卡、小红书 3:4 封面、视频号横版等

低性能模式

按 B 键可关闭 WebGL / canvas 动画,动态内容退回静态背景,老设备也能正常演示。


适合谁用 / 不适合谁用

✅ 合适

  • • 线下分享 / 行业内部讲话 / 私享会
  • • AI 产品发布 / demo day
  • • 带强烈个人风格的演讲
  • • 方法论 / 产品分析类内容
  • • 需要生成多平台封面

❌ 不合适

  • • 大段表格数据展示
  • • 高信息密度培训课件
  • • 需要多人协作编辑的场景(静态 HTML 协作不便)

为什么是 HTML PPT?

作者在技能文档里解释了做出这个选择的原因:

HTML / CSS 是文本,AI 能直接读、改、验证。表现力比 Markdown 更高,可以做精细排版、空间定位、动画和响应式封面。交付是单文件,不需要服务器,浏览器直接打开。

换句话说:HTML PPT 这件事,天然适合 AI Agent 来做——AI 生成 HTML 的能力和生成 Markdown 差不多,但输出的东西更接近最终可用的形态。


30 秒安装

最简单的方式,直接把这段话发给有 shell 权限的 AI Agent(比如 Claude Code):

帮我安装 guizang-ppt-skill。请把 https://github.com/op7418/guizang-ppt-skill 克隆到 ~/.claude/skills/guizang-ppt-skill,安装完成后检查 SKILL.md、assets/、references/ 是否存在。

安装好后,直接对 Agent 说人话:

帮我基于这篇文章做一份瑞士风 PPT,控制在 7 页左右,需要 2-3 张配图。

或者:

帮我把这个产品分析文档做成电子杂志风 PPT,重点突出观点和叙事节奏。

生成多平台封面

这个技能还能基于同一份内容生成多个平台的封面:

  • • 公众号 21:9 头图:大标题优先,右侧或边缘保留视觉锚点
  • • 1:1 分享卡:与头图共用主题色、关键词和视觉元素
  • • 小红书 3:4 封面:大标题优先,多张时统一字号和视觉节奏
  • • 视频号横版 16:9:适合标题 + 副标题 + 单一视觉焦点

封面的核心原则和 PPT 一样:只用少量关键词,视觉重心落在大标题上,不要把正文堆满


瑞士风版式校验

Style B 瑞士风有强校验机制,生成完成后跑一下:

node scripts/validate-swiss-deck.mjs path/to/index.html

校验器会检查:

  • • 是否有页面用了不在 22 种具名版式里的结构
  • • 是否有居中标题、实验版式
  • • 危险 SVG 问题
  • • 图片是否脱离预设槽位

P0 级问题必须全过才能交付。


主题色不许自定义

这是技能里一条很有意思的设计原则:不允许自定义 hex 值

从预设主题里选——保护美学比给自由更重要。如果每次都能自定义颜色,整体风格的稳定性就无法保证。

预设主题列表:

Style A(5套):墨水经典 / 靛蓝瓷 / 森林墨 / 牛皮纸 / 沙丘

Style B(4套):克莱因蓝 IKB / 柠檬黄 / 柠檬绿 / 安全橙


目录结构

guizang-ppt-skill/├── SKILL.md              ← 主文件:工作流、原则、常见错误├── assets/│   ├── template.html         ← Style A 电子杂志风模板│   ├── template-swiss.html   ← Style B 瑞士国际主义模板│   └── screenshot-backgrounds/ ← 截图美化内置背景├── scripts/│   └── validate-swiss-deck.mjs ← 瑞士风版式校验器└── references/    ├── components.md     ← 组件手册    ├── layouts.md        ← 10 种页面布局骨架    ├── layouts-swiss.md  ← 22 种瑞士风锁定版式    ├── swiss-layout-lock.md ← 瑞士风还原度和版式硬约束    ├── themes.md         ← 5 套主题色预设    ├── themes-swiss.md   ← 4 套瑞士风锚点色    ├── image-prompts.md  ← 配图提示词参考    ├── screenshot-framing.md ← 截图适配语义    └── checklist.md      ← 质量检查清单(P0/P1/P2/P3)

总结

guizang-ppt-skill 是一个把"AI 生成 PPT"这件事真正做对的技能。它的核心价值在于:

  1. 1. AI 原生:HTML 是 AI 能直接生成和验证的格式,输出即是交付物
  2. 2. 风格收敛:22 种具名版式 + 预设主题色,把美学决策提前,AI 和用户都不用从零选择
  3. 3. 多场景覆盖:PPT、配图、多平台封面,一套视觉规则走天下
  4. 4. 质量可控:瑞士风有校验脚本,P0 级问题自动拦截

如果你的工作流里经常需要用 AI 做演示类内容,不妨试试这个技能——它可能是目前最接近"让 AI 真正替你做完 PPT"这个目标的一个解法。


相关链接:

  • • GitHub:https://github.com/op7418/guizang-ppt-skill
  • • 作者 Twitter/X:@op7418[1]

本文由钱小虾整理,参考了 guizang-ppt-skill 官方 README。

引用链接

[1] @歸藏: https://x.com/op7418

——关注我,获取OpenClaw最新更新解析、使用技巧,解锁AI助手更多隐藏功能✨