跳转到使用指南
guizang-ppt-skill作者 op7418

Guizang PPT Skill Skill.

Claude Code 和 Codex 的 PPT 与幻灯片 skill:单文件横向 HTML 演示文稿,杂志或瑞士风格,带演讲者视图和同步。

  • Presentations
  • HTML 幻灯片
op7418/guizang-ppt-skill · SKILL.mdSKILL.md
--- name: guizang-ppt-skill description: 生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、演讲者视图、观众屏同步、讲稿备注、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"时使用。 --- ## 这个 Skill 做什么 ## 何时使用 ## 工作流 ## 资源文件导览 ## 核心设计原则(哲学) ## 参考作品
前言和章节标题读取自 2026-09-14 的上游文件 · 完整内容 25,146 字符

01 功能说明

guizang-ppt-skill Skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

生成一个横向滑动的网页幻灯片集,作为单个自包含的 HTML 文件,具备 WebGL 主视觉背景、演讲者视图、观众屏幕同步、演讲备注、章节分隔页、大数字数据页和图片网格。两种互斥的视觉方向:A,电子杂志 x 电子墨水风格(衬线标题、流体背景、暖色调);B,瑞士国际主义风格(全无衬线、12 栏网格、网格点背景,从 IKB、柠檬黄、柠檬绿或安全橙中选取一种高对比强调色)。

风格 B 的正文页必须使用 22 种已注册布局之一,S01-S22,并以 data-layout 标记。适用于希望一次性完成幻灯片、无需借助其他演示工具的设计师和开发者,用于制作演讲、发布会和演示日的内容。

它产出什么

  • 一个横向翻页的单文件 HTML 幻灯片集,作为一个自包含文档交付,CSS、WebGL 着色器、翻页 JS 和演讲者模式均已接入完毕。
  • 一个按幻灯片 data-slide-id 值相同顺序生成的 SPEAKER_NOTES 记录,包含目的、讲述内容、过渡以及可选的场面调度字段。
  • 大纲,作为 markdown 文件保存在幻灯片集旁边,供后续迭代使用。
查看示例提示词 ↗

工作方式

  1. 01
    先检查上游是否有更新

    该 skill 会拉取仓库并计算 HEAD 落后上游多少个提交,然后在拉取任何内容之前询问用户。

  2. 02
    写作前先就七个问题达成一致

    首先确定风格 A 或 B,然后是受众与场合、时长、素材来源、图片或截图、主题配色以及硬性限制。

  3. 03
    复制所选模板

    将 assets/template.html(风格 A)或 assets/template-swiss.html(风格 B)复制到幻灯片集所在位置,并创建同级的 images 文件夹。

  4. 04
    预检类名

    在编写任何幻灯片标记之前先阅读模板的样式区块,并核实所用的每个类都在其中定义。

  5. 05
    在选择布局前先规划主题节奏

    先写出每一页的主题类(hero dark、hero light、light、dark),对齐之后再选择布局。

  6. 06
    对照检查清单自查

    生成完成后,打开 references/checklist.md 并逐项过一遍,然后运行验证器和浏览器预览。

02 找到适合场景

何时使用 guizang-ppt-skill Skill

当任务是制作 PPT 和幻灯片时,在 Claude Code 或 Codex 中使用 guizang-ppt-skill skill。适用范围和限制来自该 skill 自身的文件。

适合场景

  • 线下分享会、内部行业演讲以及演讲者希望在大屏幕上呈现有存在感的幻灯片集的私人沙龙。
  • 需要一份完成度高、可立即演示的幻灯片集的 AI 产品发布会和演示日。
  • 需要一次性完成、无需借助单独翻页或演示工具的网页幻灯片。
  • 由大量 KPI 数字、路线图和流程构建的内容,天然适合风格 B 的 Data Hero 布局。

了解边界

  • 承载大型数据表格或堆叠图表的页面,则改用传统的幻灯片工具处理。
  • 培训课件,因为这种格式的信息密度太低。
  • 需要多人协同编辑的工作,因为输出是静态 HTML。
  • 发明超出已注册 22 种布局之外的新版式结构,例如 P23/P24、Swiss Image Split 或 Evidence Grid,除非用户明确要求实验性布局。

需要提供的信息

  • 一个主题,或素材来源文档、数据、旧的演示文稿或文章链接可以让 skill 基于真实素材来构建;如果只有一个模糊的想法,它会借助叙事弧模板来搭建大纲。
  • 首先确定的风格选择风格 A 或 B 决定使用哪一套模板、布局和主题文件,因此这是必须首先确认的问题。
  • 受众与场合是内部行业演讲、商业发布会、demo day 还是私人沙龙,会决定语言基调和内容深度。
  • 图片与截图,附带命名规范和规格图片放在 index.html 旁边的 images/ 文件夹中,并遵循“页码加语义”的命名规范,以保持页面顺序清晰可读。
  • 硬性约束任何必须包含的内容(如特定数据点)或绝不能出现的内容,都会提前收集,以避免返工。

03 Skill 内部

guizang-ppt-skill Skill 为 Claude Code 和 Codex 设定的规则

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

  1. 切勿混用两种风格

    一份演示文稿只使用一种风格。相同的类名在两套模板中渲染效果完全不同,因此布局类只存在于与之匹配的模板文件中。

  2. 固定的主题色板,不使用自定义十六进制颜色

    只允许使用从 themes.md 中挑选出的五套精心调校过的预设方案,且一份演示文稿全程只使用一套主题。

  3. 每一页都要声明其主题

    每个部分必须带有 light、dark、hero light 或 hero dark 之一,仅仅是 hero 是不够的。

  4. 风格 B 页面必须声明布局 ID

    Swiss deck 运行在锁定模式下:正文页面只使用 22 种已注册布局,且每个幻灯片 section 都写入 data-layout="Sxx"。

  5. 图标来自 Lucide,而非手绘 SVG

    通过标记加 lucide.createIcons() 使用棱角分明的 Lucide 图标集,而不是手绘图形,并避免使用 emoji;风格 B 还要求所有文字标签都不放在 SVG 中,而是放在 HTML 网格或说明文字里。

  6. 图片网格使用固定的视口高度

    在风格 A 的图片网格中,应设置 height:Nvh 而非 aspect-ratio,后者会破坏布局。

  7. 演讲者备注以稳定的页面 ID 为键

    每个部分都获得一个唯一且稳定的 data-slide-id,备注记录也按相同顺序生成。备注按页面 ID 存储,绝不按数组索引或页码存储。

  8. 时长决定页数

    十五分钟对应约 10 页,三十分钟对应约 20 页,四十五分钟对应 25-30 页。

04 投入使用

在 Claude Code 或 Codex 中安装 guizang-ppt-skill

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

将 guizang-ppt-skill 添加到 Claude Code、Codex 或你的 Agent

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

Terminal
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

用于 SKILL.md 的通用 skills CLI 形式;仓库可能会记录自己的路径。

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

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

Starter prompt
帮我做一份 30 分钟左右的分享 deck,受众是公司内部的产品和工程同学,风格选 B 瑞士国际主义。素材是这份 [产品发布文档] 和 [几张 dashboard 截图],截图想保真放进 S22 的主图和 S15 的图片格。主题色用克莱因蓝 IKB,另外需要 20 页左右的页面计划和每页的讲稿备注。

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

检查首次结果

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

  • 在交付前运行 Swiss deck validator;它会执行静态结构检查,并在 Playwright 可用时测量渲染后的可见边界、底部留白、导航安全线和标题间距。

在 OpenDesign 中已内置 guizang-ppt-skill:Plugins → Skills,在顶部栏中选择即可。

05 开源、可追溯

来源、许可与验证

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

Author
op7418
Skill 文件
SKILL.md 验证时记录的内容校验和;提交 c91369c
License
AGPL-3.0 来自 LICENSE。
仓库星标数
26,246 GitHub 快照拍摄于 2026-09-14,针对整个 op7418/guizang-ppt-skill 仓库。不是 guizang-ppt-skill 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可证文本和星标数。已捆绑在 OpenDesign 主版本中(检查于 2026-08-28);此页面尚未记录实际运行。
Skill 自身的描述
"生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、演讲者视图、观众屏同步、讲稿备注、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB / 柠檬黄 / 柠檬绿 / 安全橙高亮)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"时使用。"

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

Guizang PPT Skill

在真实的 PPT 和幻灯片任务上运行 guizang-ppt-skill。

guizang-ppt-skill skill 内置于 OpenDesign。下载应用,在 Plugins → Skills 中选择该 skill,粘贴上面的提示词,在结果生成前阅读计划。

终端
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows