关于 slide-deck
slide-deck 是用于生成独立 HTML 幻灯片的技能,可在浏览器中演示、分享或打印为 PDF。它指导内容结构与视觉设计,并包含导航功能和自适应布局。
主要功能
- 01生成单文件 HTML 幻灯片
- 02按每页一个观点组织内容
- 03提供键盘与滚动导航
- 04包含页码计数器和打印样式
- 05采用自适应布局与原生 Web 代码
- 06根据受众和演示类型调整内容
适用场景
- 01根据笔记或文档制作演示文稿
- 02准备内部汇报或融资演示
- 03制作培训或会议演讲幻灯片
- 04分享浏览器演示文稿或导出 PDF
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ thecraighewitt/ skills --skill slide-deck安装后在 Claude Code 中输入/slide-deck确认已加载。
附带文件evals/evals.json
详细介绍
幻灯片
生成一个独立的 HTML 幻灯片文件,用户可以在浏览器中演示、分享链接或导出为 PDF。开箱即用的效果应当专业——不要使用默认的 Reveal.js 模板,也不要用企业风格的剪贴画。
开始之前
只需收集足够的背景信息,让幻灯片内容具体:
- 主题——用一句话说明幻灯片的主题。
- 受众——面向哪些人?(内部团队、客户、投资者、会议听众、学生)
- 长度——大致需要多少张幻灯片(未指定时默认为 12–15 张)
- 源材料——指出工作文件夹中的文档、笔记或文字记录,或直接粘贴原始输入
- 语气——正式、随意、有冲击力,还是平实?
- 品牌——有指定的颜色、字体或视觉参考吗?先检查文件夹中是否有
BRAND.md或brand-guidelines.md。
如果用户只说了类似“做一套关于 X 的幻灯片”,没有提供更多细节,就大胆推断并直接生成草稿——如果方向不对,他们会再提出调整意见。
结构模板
大多数幻灯片都适合采用以下五幕结构:
- 标题——一张幻灯片,呈现核心观点和演讲者
- 引子——1–2 张幻灯片,说明为何此刻值得关注
- 论证——6–10 张幻灯片,分步展开论据
- 转折/落点——1–2 张幻灯片,呈现结论、重新审视的角度或请求
- 结尾——1 张幻灯片:联系方式、下一步、行动号召
针对特定类型的幻灯片,灵活调整:
- 融资路演——问题/解决方案/市场/业绩进展/商业模式/团队/融资诉求
- 培训——成果/背景/方法(多张幻灯片)/示例/练习/后续步骤
- 会议演讲——故事开场/问题/历程/框架/示例/行动号召
- 内部进展汇报——TL;DR/指标/已交付事项/后续计划/待决策事项
视觉系统
如果没有提供品牌参考,默认采用以下风格:
- 布局——留白充足,每张幻灯片最多呈现一个观点。避免大段文字。
- 字体——标题使用一种无衬线字体(Inter、IBM Plex Sans 或类似字体),正文使用另一种。标题字号较大(60–90px),正文阅读舒适(24–32px)。
- 颜色——浅色背景(米白或近白色)、一种鲜明的强调色(默认:沉稳的青绿色或柔和的蓝色)和中性色文字。谨慎使用强调色——每张幻灯片最多突出一个数字、一个词或一条下划线。
- 图像——优先使用简单的几何图形、图表和字体强调,而非图库照片。如果使用图像,请保持风格一致。
- 幻灯片编号——小巧、不显眼地放在角落。
- 转场——不使用转场,或使用简洁的淡入淡出。不要使用花哨的擦拭效果。
如果用户提供品牌颜色/字体,请使用。如果用户提供参考幻灯片或网站,请沿用其视觉风格。
技术实现
生成一个独立的 .html 文件。保存到工作文件夹,文件名为 slides-[topic-slug].html。
必需功能:
- 滚动吸附导航——每张幻灯片占满整个视口,滚动时在幻灯片之间平滑切换
- 键盘导航——使用方向键和空格键切换,按 Esc 键进入总览
- 幻灯片计数器——显示小巧的“3 / 15”指示器
- 打印/PDF 样式表——确保每张幻灯片打印在一页上,不会出现不自然的溢出。用户经常会导出为 PDF,因此此功能必须可靠。
- 响应式——在笔记本电脑、投影仪和大型外接显示器上都清晰易读。不要过度针对移动设备优化。
使用原生 HTML/CSS/JS。不要添加外部依赖,也不要使用离线时可能无法加载的 CDN 字体。如需自定义字体,请将其以 base64 嵌入,或使用系统字体栈。
内容规则
- 每张幻灯片只讲一个观点。 如果一张幻灯片包含两个相互竞争的观点,就把它拆开。坚持每张幻灯片只讲一个观点,才能让演示文稿摆脱“满屏项目符号”的样子。
- 让标题发挥作用。 幻灯片的标题应该单独就能传达核心要点。正文内容用于支撑标题。不要让观众必须阅读正文才能弄清楚这张幻灯片在讲什么。
- 数字单独成页。 一个醒目的数字(“$1.5M ARR” 或 “62% 留存率”)值得占满一张幻灯片。不要把它埋在项目符号里。
- 项目符号列表不超过 3 项。 如果需要列出 5 项,就拆成两张幻灯片,或者重新考虑结构。
- 优先使用图表而非表格。 展示数据时,请使用图表。如果必须使用表格,最多保留 4 行。
- 演讲者备注(可选)。 如果用户提出要求,请添加
<aside class="notes">块,写上幻灯片之外需要讲述的内容。备注应比幻灯片内容更精简——它们是提示,而不是讲稿。
生成后
告诉用户:
- 文件路径
- 如何打开(双击即可,或运行
open slides-x.html) - 如何浏览(使用方向键 / 滚动)
- 如何导出为 PDF(在浏览器中打印为 PDF)
- 如果想要修改,可以提出什么要求——常见选项包括:精简文案、调整视觉风格、添加 / 删除幻灯片、更改语气
后续自定义
如果用户之后提出“把这些改得更 [X]”,请整体调整——重新渲染整套演示文稿,而不是只修补一张幻灯片。整套演示文稿应保持协调统一。
这样设计的原因
幻灯片工具(PowerPoint、Keynote、Slides)很容易让幻灯片塞满文字,而没有模板又很难做得专业。将演示文稿生成为 HTML,可以从设计上确保每张幻灯片只讲一个观点,并产出真正具有设计感的作品。用户始终可以将其导出为 PDF 以便分享。