lewislulu /html-ppt-skill

HTML PPT Studio — AgentSkill with 24 themes, 31 layouts, 20+ animations for building professional HTML presentations

★ 9,099⑂ 769👁 25⑃ 28● 22▤ 0
HTMLMITCreated 2026-04-15
+9
日增长
9,099
stars
769
forks
25
watchers
28
prs
22
issues
0
releases

README

html-ppt · HTML PPT 工作室

 一款专业级的 AgentSkill,让 AI 做出真正能打的 HTML 演示文稿。
 36 套主题、15 套完整 deck 模板、36 种页面布局、47 个动效
 (27 个 CSS + 20 个 Canvas FX),加上全新的 演讲者模式 —— 像素级
 完美预览 + 逐字稿提词器 + 计时器。纯静态 HTML/CSS/JS,无需构建。

作者: lewis <[email protected]>
协议: MIT
English docs: README.md

!html-ppt 封面 · 实时预览

 一行命令装好 36 主题 × 20 Canvas FX × 36 布局 × 15 完整 deck + 演讲者模式。
 上图里的每一个预览都是真实的 iframe 加载真实模板文件 —— 不是截图,不是色卡。

 🎤 演讲者模式(全新)

在任何 deck 里按 S 键,弹出一个独立的演讲者窗口,包含 4 个可拖拽、
可调整大小的磁吸卡片:当前页预览、下一页预览、逐字稿、计时器。两个窗口
通过 BroadcastChannel 双向同步翻页。

!演讲者模式 · 4 个磁吸卡片

为什么预览是像素级完美的: 每个卡片是一个 ,加载的是同一
份 deck HTML 文件,只是 URL 多了 ?preview=N 参数。runtime 检测到这个
参数后,只渲染第 N 页并隐藏所有 chrome —— 所以预览使用和观众视图完全相
同的 CSS、主题、字体、viewport,颜色和排版保证 100% 一致。

丝滑翻页(零闪烁): 翻页时演讲者窗口通过 postMessage({type:'preview-goto',
idx:N}) 通知 iframe,iframe 只是切换 .is-active class —— 不重新加载、
不白屏、不闪烁。

逐字稿 3 条铁律:
1. 提示信号,不是讲稿 — 关键词加粗,过渡句独立成段
2. 每页 150–300 字 — 约 2–3 分钟/页的节奏
3. 用口语,不用书面语 — "所以" 不是 "因此","这个" 不是 "该"

详见 references/presenter-mode.md,或直接复制
templates/full-decks/presenter-mode-reveal/ 这个现成模板 —— 每一页都带完整
150–300 字的示例逐字稿。

 一行命令安装

bash
npx skills add https://github.com/lewislulu/html-ppt-skill


装好后,任何支持 AgentSkill 的 agent(Claude Code / Codex / Cursor / OpenClaw 等)
都能用这套能力做 PPT。对 agent 说:

 "做一份 8 页的技术分享 slides,用 cyberpunk 主题"
 "把这段 outline 变成投资人 pitch deck"
 "做一个小红书图文,9 张,白底柔和风"
 "做一份带演讲者模式的产品分享,我想要有逐字稿"

 离线 / 手动安装

npx skills add  需要目标机器能联网。下面三种方式,对网络的依赖依次递减。

1. 从本地副本安装。 在任意能联网的机器上取到仓库,把整个目录搬过去(git、zip、U 盘都行),
然后把 CLI 指向本地目录而不是 URL:

bash
git clone https://github.com/lewislulu/html-ppt-skill
npx skills add ./html-ppt-skill


npx 本身仍需下载一次 skills 包。完全隔离的机器请先在联网机器上
npm i -g skills,或者直接用方式 2。

2. 纯手工拷贝 —— 不需要 Node,也不需要 CLI。 一个 skill 就是一个根目录下放着
SKILL.md 的文件夹。放进你的 agent 会扫描的目录即可:

| Agent | 项目级 | 全局 |
|---|---|---|
| Claude Code | .claude/skills/html-ppt/ | ~/.claude/skills/html-ppt/ |
| Codex | .agents/skills/html-ppt/ | ~/.codex/skills/html-ppt/ |
| Cursor | .agents/skills/html-ppt/ | ~/.cursor/skills/html-ppt/ |
| OpenCode | .agents/skills/html-ppt/ | ~/.config/opencode/skills/html-ppt/ |
| Gemini CLI | .agents/skills/html-ppt/ | ~/.gemini/skills/html-ppt/ |
| Windsurf | .windsurf/skills/html-ppt/ | ~/.codeium/windsurf/skills/html-ppt/ |

bash
mkdir -p ~/.claude/skills
cp -R html-ppt-skill ~/.claude/skills/html-ppt
ls ~/.claude/skills/html-ppt/SKILL.md       必须存在


运行时只需要 SKILL.md、assets/、templates/、references/、scripts/。
docs/ 是约 4.6 MB 的 README 配图,离线拷贝时可以删掉。

3. 完全不用 agent。 模板就是普通静态文件,可以直接用:

bash
./scripts/new-deck.sh my-talk
open examples/my-talk/index.html


 断网能用吗?

能,只有一个前提要说清楚。主题、布局、动效、演讲者模式、PNG 导出全部是本地静态
HTML/CSS/JS,零构建、运行时不发请求。唯一的远程依赖是 assets/fonts.css,
它 @import 了 Google Fonts。

断网时这些 import 直接失败,浏览器回落到 assets/base.css 里已经声明好的系统字体栈
(-apple-system / Helvetica / Georgia / Menlo),所以 deck 照常渲染,只是字体不同。
如果要在离线环境下锁定字体,把 assets/fonts.css 换成指向自带字体文件的 @font-face
规则,或者删掉这些 import、接受系统字体。

 Skill 内容一览

| | 数量 | 位置 |
|---|---|---|
| 🎤 演讲者模式 | 新增 | S 键 / ?preview=N |
| 🎨 主题 | 36 | assets/themes/.css |
| 📑 完整 deck 模板 | 15 | templates/

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON