关于 slide-wright
slide-wright 是将主题或粗略笔记制作成独立 HTML 演示文稿的技能,适用于需要策略或产品汇报材料的人。新建时先提交主题和两页预览,获得批准后再完成整套幻灯片。
主要功能
- 01从主题或笔记生成演示文稿
- 02先提供主题方案与两页预览
- 03批准后制作完整幻灯片
- 04在现有演示文稿中直接编辑
- 05支持导出 PDF 或 PowerPoint
适用场景
- 01把研究笔记整理成汇报演示文稿
- 02先确认视觉方向再制作整套幻灯片
- 03修改已有的 reveal.js HTML 演示文稿
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ arifszn/ slide-wright --skill slide-wright安装后在 Claude Code 中输入/slide-wright确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdINSTALL.mdpackage.jsonLICENSE.claude-plugin/marketplace.json.github/workflows/test.ymlslide-wright/.claude-plugin/plugin.jsonslide-wright/references/code-slides.mddeck-template.mddesign-aesthetics.mddeploy.mdmotion-recipes.mdexport-pdf.mdmedia.mdexport-pptx.mdtheme-generation.mdexhibits.mdnew-deck.mdslide-wright/scripts/export-pptx.mjscheck-deck.mjsslide-wright/scripts/lib/deps.mjsextract.mjspackage.mjstests/export-pptx.test.mjstests/fixtures/webfonts.htmledge.htmlcode.htmlbasic.htmltests/lib/offline.mjspixels.mjs详细介绍
slide-wright
将主题或粗略笔记转化为适合董事会展示的演示文稿:幻灯片应达到优秀战略或产品团队制作的演示文稿水准,并以一个可在任何浏览器中运行的独立 HTML 文件交付。
定义此技能的规则
先提出设计方向,再制作演示文稿。首次处理时,绝不直接生成完整的演示文稿。你要先设计一个主题,用它制作两张幻灯片的预览,然后暂停,等待用户批准方向。只有获得批准后,才能制作其余内容。
一次只提出一个方案,不要给出选项菜单。如果用户不同意,就舍弃这个方向,尝试一个明显不同的方案。每个主题都要为当前演示文稿专门设计;不使用预设主题库。
**新建演示文稿:先阅读 slide-wright/references/new-deck.md。**其中包含步骤 1-4(构思演示文稿、提出设计方向、获得同意、制作演示文稿)以及确切的审批门槛。
引擎(仅供内部使用)
演示文稿使用从 CDN 加载的 reveal.js 渲染,但这是实现细节,用户无需知晓。只讨论幻灯片、主题和设计;库的名称只出现在生成的 <link> 和 <script> 标签中。slide-wright/references/deck-template.md 包含确切的设置方法。
编辑已有演示文稿
如果用户提供了现有的 HTML 演示文稿,检查它是否基于 reveal.js 构建(查找来自 CDN 的 reveal.js <link>/<script> 标签)。如果是——无论这个技能是否制作了它——都不要从头开始:阅读并保留其主题,直接在原文档中进行修改。其设计方向已获批准,因此跳过提案和审批环节。编辑后,运行 node <skill-dir>/scripts/check-deck.mjs <deck.html>,并修复它打印的所有问题(详情见 slide-wright/references/new-deck.md)。
除非要添加新的展示类型(阅读 slide-wright/references/exhibits.md)、代码(阅读 slide-wright/references/code-slides.md)或动画(阅读 slide-wright/references/motion-recipes.md),否则编辑不需要参考文件。
如果 HTML 演示文稿使用的不是 reveal.js(例如其他引擎、纯幻灯片等),则不属于此技能的编辑范围——请说明这一点,不要强行改用其他引擎重写。本文其余内容均适用于新建演示文稿。
步骤 5 — 交付
- 打开制作完成的演示文稿。
- 告知用户文件位置、主题名称和幻灯片数量。
- 告诉用户如何操作:使用方向键、空格键或滑动切换;按 F 进入全屏,按 Esc 或 O 查看幻灯片总览,按 S 打开含备注的演讲者视图;在 URL 后添加
?print-pdf并打印即可保存为 PDF(步骤见slide-wright/references/export-pdf.md);主题颜色位于:root变量中,字体位于<link>中。 - 提供接下来的常见选项:修改内容、更换主题、导出 PDF、导出 PowerPoint 文件(
slide-wright/references/export-pptx.md),或部署到线上 URL以便分享。如果用户想部署,请阅读slide-wright/references/deploy.md,并让他们选择托管服务(Surge、Vercel 或 Netlify)——不要自行假定。
参考文件
按需查阅这些文件,不要一次性全部阅读:
slide-wright/references/new-deck.md— 新建演示文稿的步骤 1-4:梳理演示文稿、提出视觉风格方案、征求确认、制作演示文稿slide-wright/references/design-aesthetics.md— 让演示文稿看起来经过设计的要素(步骤 2)slide-wright/references/theme-generation.md— 创建主题的流程(步骤 2)slide-wright/references/deck-template.md— HTML 框架、布局和引擎设置(步骤 2 和 4)slide-wright/references/exhibits.md— 为每张内容页选择并构建视觉元素(步骤 2 和 4)slide-wright/references/code-slides.md— 代码页及其标记规范(步骤 4)slide-wright/references/motion-recipes.md— 动画,仅在用户提出需求时使用(步骤 4)slide-wright/references/media.md— 幻灯片中的图像和视频(步骤 4)slide-wright/references/export-pdf.md— 将演示文稿保存为 PDF(步骤 5)slide-wright/references/export-pptx.md— 将演示文稿导出为 PowerPoint,同时保留可编辑文本(步骤 5)slide-wright/references/deploy.md— 将演示文稿发布到在线 URL(步骤 5)