convez.ai
SkillProdutividadeIntermediário
sunxiaohui2025

Claude PPT Skills - Gerador de Apresentações HTML Editáveis

sunxiaohui2025/claude-ppt-skills

Gera PPTs HTML elegantes e editáveis para apresentações profissionais direto do Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para gerar apresentações HTML de alta qualidade com 6 estilos visuais (Dune, Ink Classic, Indigo Porcelain, Editorial Mono, Mist Lab, Porcelain Green). Permite criar PPTs a partir de esboços, Markdown ou anotações, com suporte a edição online, pré-visualização e navegação via teclado. Estruturado em módulos validáveis e executáveis via scripts Python para garantir saídas estáveis e sem erros.

Instalação

$npx convez-ai sunxiaohui2025/claude-ppt-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Converter esboços e anotações em apresentações executivas prontas
  • Gerar decks de tecnologia e pesquisa com estilo Indigo Porcelain ou Mist Lab
  • Criar apresentações corporativas com visual alto padrão e edição colaborativa online
  • Produzir slides estilo Keynote/TED com tipografia e espaçamento profissional

Veredito

Skill robusto e bem arquitetado para gerar PPTs profissionais via IA. Destaca-se pela imposição de padrões rígidos (modularização, validação, runtime estável) que evitam saídas quebradas — essencial em ambiente de agentes. Curva de aprendizado moderada, requer respeito ao fluxo prescrito (gerar outline → validar → mesclar), mas entrega resultado polido e sustentável.

README

A tradução para o português deste README ainda está na fila.

生成可编辑的Html格式的的PPT Skill

一个用于生成高端宣讲风格 HTML PPT 的 Codex Skill,适配 Claude Code / Codex 等 Agent 环境的网页 PPT 技能,用于生成单文件 HTML 横向翻页 PPT、PPT 配图和多平台封面。

它适合把大纲、笔记、Markdown、粗略想法或技术材料,转换成一套可以直接演示的 HTML 幻灯片。默认视觉风格是「沙丘色」:暖米色背景、陶土主色、克制动效、大标题叙事、宽松留白,整体更接近发布会 / Keynote / 技术宣讲,而不是传统 PPT 模板。

六种风格

可以网页在线编辑

在线预览

这个 Skill 解决什么问题

它希望解决 AI 生成 PPT 时常见的几个问题:

  • 页面像传统办公 PPT,不够高级。
  • 内容硬塞在一页里,字号越来越小。
  • 连续多页都是卡片或列表,视觉疲劳。
  • 章节页、封面页、结尾页没有舞台感。
  • HTML PPT 生成后缺少稳定的快捷键、缩略图和编辑能力。
  • 不同智能体生成时容易改坏运行时代码,导致黑屏或保存失败。

这个 Skill 的核心目标是:让 AI 不只是“把内容放进页面”,而是先判断内容主角,再选择合适版式,并通过标准模板生成稳定可维护的 HTML PPT。

最重要的生成原则

这个 Skill 不是让智能体从零手写一个 HTML PPT。

正确流程只有一个:

  1. 生成或修改 sources/ 下的模块化源文件。
  2. 运行 scripts/merge_deck.py 合并。
  3. 运行 scripts/validate_deck_contract.py 校验。
  4. 只交付合并后的 index.html。

以下都属于错误输出:

  • 自己写一个完整 <!doctype html>。
  • 用 .slide { min-height: 100vh; } 做纵向滚动页面。
  • 用 scrollIntoView 自己实现翻页。
  • 没有 overviewGrid。
  • 没有 editToolbar。
  • 没有底部 pageText、prevBtn、nextBtn。
  • 每页没有 data-source 和 data-slide-id。
  • 每页没有 .slide-stage。
  • 自己写 <script> 替换标准 runtime。

哪怕页面看起来像 PPT,只要没有走标准模板和合并脚本,就不是合格产物。

核心能力

  • 生成高端色宣讲风格 HTML PPT。
  • 生成前先收集风格、受众、场景、目标和页数等关键信息。
  • 根据用户需求先生成大纲,并在用户确认后再开始生成 PPT。
  • 支持模块化源文件,便于后续维护和二次编辑。
  • 内置标准运行时,支持翻页、缩略图、全屏、编辑模式。
  • 根据内容自动选择版式:封面、章节、目录、卡片、图文、对比、流程、时间轴、层级、图表、结论、封底等。
  • 自动执行信息减法:内容过多时拆页,而不是压缩到看不清。
  • 避免连续多页重复使用同一种卡片 / 目录 / 列表版式。
  • 章节页采用 Cinematic Section 风格,更像镜头切换。
  • 支持未来扩展多种视觉风格,不需要重写生成流程。
  • 内置校验脚本,避免生成缺少运行时、缺少数据源、JS 双重转义等问题的坏文件。

设计风格

默认风格:dune 沙丘色。

核心色彩:

  • 背景色:#fbf7ef
  • 主色调:#a8553d
  • 正文色:深墨色 / 暖黑色
  • 整体气质:高级、克制、宽松、建筑感、适合投屏宣讲

设计原则:

  • 每页只表达一个主观点。
  • 标题要大,重点词用主色突出。
  • 上下左右要有足够留白,贴近 16:9 安全内容区。
  • 封面、章节页、结尾页可以有更明显的舞台感和动效。
  • 内容页动效要克制,优先保证清晰、稳定、可读。
  • 发现内容太多时,优先拆页,不要硬塞。
  • 避免连续多页都是卡片、目录或普通列表。

当前内置 6 套风格:

风格 ID中文名适合场景
dune沙丘色默认风格,温暖、高端、宣讲通用
ink-classic黑色经典商业发布、行业内部讲话、线下分享、私享会
indigo-porcelain靛蓝瓷AI、研究、技术发布会、架构分享
editorial-mono杂志直白专刊个人观点、行业观察、专家演讲、杂志风私享会
mist-lab雾紫实验室AI 研究、技术判断、架构思考、理性私享会
porcelain-green青瓷技术档案平台能力、Agent 架构、流程设计、技术宣讲

目录结构

dune-keynote-slide/
├── SKILL.md
├── README.md
├── agents/
│   └── openai.yaml
├── assets/
│   └── html-template/
│       ├── base.css
│       ├── index.template.html
│       └── runtime.js
├── references/
│   ├── dune-style-guide.md
│   ├── layout-library.md
│   └── style-packs/
│       └── dune.md
└── scripts/
    ├── generate_deck.py
    ├── merge_deck.py
    ├── render_check.py
    ├── serve_editor.py
    └── validate_deck_contract.py

重点文件说明:

  • SKILL.md:Skill 的核心使用规范,告诉智能体如何生成 PPT。
  • assets/html-template/:标准 HTML 模板、基础样式和运行时代码。
  • references/dune-style-guide.md:沙丘色视觉规范。
  • references/layout-library.md:各种页面版式的选择规则和结构示例。
  • references/style-packs/dune.md:默认风格包,后续可参考它扩展新风格。
  • scripts/merge_deck.py:把单页源文件合并成最终 index.html。
  • scripts/generate_deck.py:受限运行环境专用;从参数中的 slide 源码创建 sources/,再调用 merge_deck.py 生成最终 HTML。
  • scripts/serve_editor.py:本地编辑保存服务。
  • scripts/validate_deck_contract.py:生成结果校验脚本。
  • scripts/render_check.py:可选的浏览器渲染检查脚本,在 1366×768、1280×720 和 1920×1080 视口检查重叠、溢出和底部遮挡。

生成后的 PPT 结构

一个生成后的 PPT 项目应该长这样:

my-deck/
├── index.html
└── sources/
    ├── outline.md
    ├── style.css
    ├── deck.config.json
    ├── slide-01.html
    ├── slide-02.html
    └── slide-NN.html

说明:

  • sources/slide-XX.html 是每一页幻灯片的源文件。
  • sources/style.css 是当前 PPT 的补充样式。
  • sources/deck.config.json 存放标题等配置。
  • index.html 是最终可打开、可演示的完整 HTML PPT。

智能体应该只编写 sources/ 里的文件,最终的 index.html 必须由 merge_deck.py 生成。

基础使用方式

创建一个 PPT 目录:

mkdir -p my-deck/sources

创建 sources/deck.config.json:

{
  "title": "AI 技术战略分享",
  "stylePack": "dune"
}

切换风格时只需要修改 stylePack,例如:

{
  "title": "AI 产品发布",
  "stylePack": "indigo-porcelain"
}

创建第一页 sources/slide-01.html:

<section class="slide layout-cover" data-slide-id="slide-01" data-source="sources/slide-01.html">
  <div class="slide-stage">
    <div class="cover-copy">
      <p class="eyebrow">TECH STRATEGY</p>
      <h1>AI 正在改变企业的<span>运行方式</span></h1>
      <p class="subtitle">从工具升级,到流程重构,再到组织协同方式的变化。</p>
    </div>
  </div>
</section>

合并生成最终 PPT:

python3 dune-keynote-slide/scripts/merge_deck.py my-deck

打开预览:

open my-deck/index.html

生成约束

为了保证生成结果稳定,必须遵守以下约束:

  • 生成前必须先进行需求确认,不能拿到一个标题就直接生成 PPT。
  • 必须先确认风格,默认使用 dune 沙丘色,未来可以扩展更多风格。
  • 必须先输出目标受众、主旨、章节结构、页级大纲和结尾思想,让用户确认。
  • 如果用户需求很简单,要先补全合理大纲和叙事线,并标注假设。
  • 如果用户提供了详细大纲,要尊重用户原意,只做适度提炼和页级主旨整理。
  • 用户确认大纲后,才能开始生成 sources/ 文件和最终 HTML。
  • 不要手写最终的 index.html。
  • 不要替换标准运行时、缩略图、编辑工具栏、底部进度条和快捷键逻辑。
  • 智能体只能生成或修改 sources/slide-XX.html、sources/style.css、sources/outline.md、sources/deck.config.json。
  • 最终 PPT 必须通过 scripts/merge_deck.py 合并。
  • 合并后必须通过 scripts/validate_deck_contract.py 校验。
  • 每一页都要判断内容主角:标题、图片、流程、数据、对比、层级、卡片、时间轴或结论。
  • 内容太多时必须拆页,不能通过无限缩小字号硬塞。
  • 章节页只能放章节编号、标题、一句短副标题和淡色动态图标,不要塞证明材料、列表或卡片。
  • 不要连续超过两页使用相似的卡片 / 列表 / 目录型版式。
  • 封面、章节页、封底可以更有动效,普通内容页要克制。

生成前确认流程

生成 PPT 前,智能体应该先和用户对齐内容与风格,而不是直接开始写 HTML。

需要收集或推断的信息:

  • PPT 主题 / 标题。
  • 目标受众。
  • 演示目标。
  • 使用场景。
  • 期望页数或演讲时长。
  • 视觉风格,默认是 dune 沙丘色。
  • 作者、日期等封面信息。

如果用户只给了一个标题或一句话需求,智能体应该先补全一个合理的大纲,包括:

  • 目标受众。
  • 核心主旨。
  • 整体叙事线。
  • 章节结构。
  • 每页主旨。
  • 结尾思想。

如果用户已经给了详细内容,智能体应该:

  • 保留用户的主要意思和术语。
  • 不过度发挥或改写。
  • 适度整理逻辑结构。
  • 提炼每页主旨。
  • 给出确认版大纲。

确认信息建议格式:

风格:默认沙丘色 / 用户指定风格
目标受众:...
主旨:...
叙事线:...
章节结构:...
页级大纲:
1. ...
2. ...
结尾思想:...

请确认这个方向,我确认后再开始生成 HTML PPT。

只有用户确认后,才进入正式生成流程。

快捷键

生成后的 HTML PPT 支持以下快捷键:

快捷键功能
ArrowRight、PageDown、Space下一页
ArrowLeft、PageUp上一页
O打开缩略图预览
E进入当前页编辑模式
F全屏
Esc退出全屏、缩略图或编辑模式
Cmd/Ctrl + S编辑模式下保存当前页

编辑模式

按 E 可以进入编辑模式。

当前编辑模式不是完整 PowerPoint 编辑器,而是一个轻量、可控的 HTML PPT 编辑器。它支持常用的演示稿微调能力:

  • 选择标题、段落、列表项、卡片、面板、标签、节点等元素。
  • 修改字号、加粗、颜色、对齐方式、行高。
  • 插入或清除换行。
  • 调整元素宽度、高度、内边距。
  • 设置文字不换行。
  • 复制或删除选中元素。
  • 复制、删除或强调选中的容器。
  • 按住 Alt / Option 拖拽移动元素。
  • 使用方向键微调元素位置。

保存逻辑:

  1. 如果通过 scripts/serve_editor.py 启动,本地服务会把当前页保存回 sources/slide-XX.html。
  2. 如果直接用 Chrome / Edge 打开 HTML,可以通过 File System Access API 授权访问文件夹后保存源文件。
  3. 如果浏览器或环境不支持保存,会显示明确提示。

启动本地编辑服务:

cd my-deck
python3 ../dune-keynote-slide/scripts/serve_editor.py 8765

然后打开:

http://127.0.0.1:8765/index.html

版式系统

这个 Skill 不是简单套卡片,而是根据内容语义选择版式。

常见版式包括:

  • 封面页。
  • 目录页。
  • 章节页。
  • 纯文字页。
  • 一句话观点页。
  • 图文组合页。
  • 单大图页。
  • 图标文字页。
  • 双卡片、三卡片、四宫格、多列列表。
  • 左右对比、优劣对比、新旧对比、多维对比。
  • 横向时间轴、纵向时间轴、步骤流程、循环闭环。
  • 总分结构、树状层级、中心辐射、嵌套层级、系统图。
  • 柱状图、饼图、折线图、组合图表。
  • 问题对策、目标规划、观点结论、致谢封底。

详细版式规则见:references/layout-library.md。

校验

校验整个 PPT 目录:

python3 dune-keynote-slide/scripts/validate_deck_contract.py my-deck

校验单个 HTML 文件:

python3 dune-keynote-slide/scripts/validate_deck_contract.py my-deck/index.html

校验内容包括:

  • 是否包含标准运行时代码。
  • 是否包含缩略图预览能力。
  • 是否包含编辑工具栏。
  • 是否包含底部页码、进度条和翻页按钮。
  • 每页是否包含 data-source 和 data-slide-id。
  • 每页是否包含且只包含一个 .slide-stage。
  • 是否误用了旧版 .stage 容器。
  • 首页动态图标是否使用了危险定位方式。
  • 最终 JS 是否出现了被错误转义的模板字符串,比如 \`` 或 ${...}`。
  • 最终 JS 是否出现了双重转义的正则语法。

如果本机安装了 Playwright,建议再做一次渲染级检查:

python3 dune-keynote-slide/scripts/render_check.py my-deck

如果想保留逐页截图用于人工复核:

python3 dune-keynote-slide/scripts/render_check.py my-deck --screenshots my-deck/check-shots

这个检查会打开真正的浏览器视口,重点发现静态校验看不到的问题:

  • 是否同一时间出现多页幻灯片。
  • 内容是否超出 16:9 舞台安全区。
  • 内容是否压到底部 footer 或进度条区域。
  • 模型是否把太多内容塞进章节页或密集图表页。

提示:v3 起整套 PPT 运行在固定 1280×720 设计画布上,由运行时等比缩放适配任何分辨率,因此一个分辨率通过即代表所有分辨率一致;源文件中禁止使用 vw/vh 和 @media。

多风格扩展

这个 Skill 支持未来扩展多种风格。

当前已内置:

  • dune:沙丘色,默认风格。
  • ink-classic:墨水经典。
  • indigo-porcelain:靛蓝瓷。
  • editorial-mono:黑白专刊。
  • mist-lab:雾紫实验室。
  • porcelain-green:青瓷技术档案。

新增风格建议放在:

references/style-packs/

例如:

references/style-packs/midnight.md
references/style-packs/pearl.md
references/style-packs/jade.md

每个风格包建议定义:

  • 颜色 Token。
  • 字体气质。
  • 封面图形 / 章节图形 / 结尾图形。
  • 卡片、标签、图表和结构图样式。
  • 动效预算。
  • 禁止使用的视觉模式。

注意:新增风格应该只改变视觉语言,不要改变生成契约和运行时结构。

推荐工作流

# 1. 生成或修改模块化源文件
$EDITOR my-deck/sources/slide-01.html

# 2. 合并成最终 HTML PPT
python3 dune-keynote-slide/scripts/merge_deck.py my-deck

# 3. 校验生成结果
python3 dune-keynote-slide/scripts/validate_deck_contract.py my-deck

# 4. 可选:13 寸笔记本渲染检查
python3 dune-keynote-slide/scripts/render_check.py my-deck

# 5. 打开预览
open my-deck/index.html

# 6. 可选:启动本地编辑保存服务
cd my-deck
python3 ../dune-keynote-slide/scripts/serve_editor.py 8765

当前限制

  • 它是 HTML PPT 生成系统,不是完整 PowerPoint 替代品。
  • 编辑模式是轻量编辑,不做复杂多选、自由 CSS 编辑或完整富文本编辑器。
  • 不包含 QA 自动化、图片生成、联网搜索或大型外部依赖。
  • 复杂页面结构调整建议直接改 sources/slide-XX.html 和 sources/style.css,然后重新合并。

发布前建议

提交 GitHub 前建议补充:

  • LICENSE:选择你希望使用的开源协议。
  • 示例 Deck:可以放一个 examples/ 目录,展示生成效果。
  • 截图:可以在 README 里加入封面页、章节页、缩略图模式、编辑模式截图。

License

请在发布前补充你的开源协议。

Ver o original no GitHub

Bom para

Relacionados