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 GitHubSkill 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-skills1 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
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。
正确流程只有一个:
- 生成或修改
sources/下的模块化源文件。 - 运行
scripts/merge_deck.py合并。 - 运行
scripts/validate_deck_contract.py校验。 - 只交付合并后的
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拖拽移动元素。 - 使用方向键微调元素位置。
保存逻辑:
- 如果通过
scripts/serve_editor.py启动,本地服务会把当前页保存回sources/slide-XX.html。 - 如果直接用 Chrome / Edge 打开 HTML,可以通过 File System Access API 授权访问文件夹后保存源文件。
- 如果浏览器或环境不支持保存,会显示明确提示。
启动本地编辑服务:
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
请在发布前补充你的开源协议。