mcpField
S
slide-deck

slide-deck

github.com/thecraighewitt其他16839 次安装23 周前更新
代码仓库

关于 slide-deck

slide-deck 是用于生成独立 HTML 幻灯片的技能,可在浏览器中演示、分享或打印为 PDF。它指导内容结构与视觉设计,并包含导航功能和自适应布局。

主要功能

  1. 01生成单文件 HTML 幻灯片
  2. 02按每页一个观点组织内容
  3. 03提供键盘与滚动导航
  4. 04包含页码计数器和打印样式
  5. 05采用自适应布局与原生 Web 代码
  6. 06根据受众和演示类型调整内容

适用场景

  1. 01根据笔记或文档制作演示文稿
  2. 02准备内部汇报或融资演示
  3. 03制作培训或会议演讲幻灯片
  4. 04分享浏览器演示文稿或导出 PDF

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/thecraighewitt/skills --skill slide-deck

安装后在 Claude Code 中输入/slide-deck确认已加载。

附带文件evals/evals.json

详细介绍

幻灯片

生成一个独立的 HTML 幻灯片文件,用户可以在浏览器中演示、分享链接或导出为 PDF。开箱即用的效果应当专业——不要使用默认的 Reveal.js 模板,也不要用企业风格的剪贴画。

开始之前

只需收集足够的背景信息,让幻灯片内容具体:

  1. 主题——用一句话说明幻灯片的主题。
  2. 受众——面向哪些人?(内部团队、客户、投资者、会议听众、学生)
  3. 长度——大致需要多少张幻灯片(未指定时默认为 12–15 张)
  4. 源材料——指出工作文件夹中的文档、笔记或文字记录,或直接粘贴原始输入
  5. 语气——正式、随意、有冲击力,还是平实?
  6. 品牌——有指定的颜色、字体或视觉参考吗?先检查文件夹中是否有 BRAND.md 或 brand-guidelines.md。

如果用户只说了类似“做一套关于 X 的幻灯片”,没有提供更多细节,就大胆推断并直接生成草稿——如果方向不对,他们会再提出调整意见。

结构模板

大多数幻灯片都适合采用以下五幕结构:

  1. 标题——一张幻灯片,呈现核心观点和演讲者
  2. 引子——1–2 张幻灯片,说明为何此刻值得关注
  3. 论证——6–10 张幻灯片,分步展开论据
  4. 转折/落点——1–2 张幻灯片,呈现结论、重新审视的角度或请求
  5. 结尾——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. 每张幻灯片只讲一个观点。 如果一张幻灯片包含两个相互竞争的观点,就把它拆开。坚持每张幻灯片只讲一个观点,才能让演示文稿摆脱“满屏项目符号”的样子。
  2. 让标题发挥作用。 幻灯片的标题应该单独就能传达核心要点。正文内容用于支撑标题。不要让观众必须阅读正文才能弄清楚这张幻灯片在讲什么。
  3. 数字单独成页。 一个醒目的数字(“$1.5M ARR” 或 “62% 留存率”)值得占满一张幻灯片。不要把它埋在项目符号里。
  4. 项目符号列表不超过 3 项。 如果需要列出 5 项,就拆成两张幻灯片,或者重新考虑结构。
  5. 优先使用图表而非表格。 展示数据时,请使用图表。如果必须使用表格,最多保留 4 行。
  6. 演讲者备注(可选)。 如果用户提出要求,请添加 <aside class="notes"> 块,写上幻灯片之外需要讲述的内容。备注应比幻灯片内容更精简——它们是提示,而不是讲稿。

生成后

告诉用户:

  1. 文件路径
  2. 如何打开(双击即可,或运行 open slides-x.html)
  3. 如何浏览(使用方向键 / 滚动)
  4. 如何导出为 PDF(在浏览器中打印为 PDF)
  5. 如果想要修改,可以提出什么要求——常见选项包括:精简文案、调整视觉风格、添加 / 删除幻灯片、更改语气

后续自定义

如果用户之后提出“把这些改得更 [X]”,请整体调整——重新渲染整套演示文稿,而不是只修补一张幻灯片。整套演示文稿应保持协调统一。

这样设计的原因

幻灯片工具(PowerPoint、Keynote、Slides)很容易让幻灯片塞满文字,而没有模板又很难做得专业。将演示文稿生成为 HTML,可以从设计上确保每张幻灯片只讲一个观点,并产出真正具有设计感的作品。用户始终可以将其导出为 PDF 以便分享。

评论

支持 Markdown