marp-slide

marp-slide 技能概览

marp-slide 能做什么

marp-slide 技能可以帮助智能体把零散、粗糙的演示需求，整理成更完整、更像成品的 Marp 幻灯片 deck：它内置了可直接使用的主题、幻灯片结构建议，以及面向 Marp 的语法参考。它最适合那些想要尽快拿到可用的 slide markdown 的人，而不是只得到一句泛泛的“帮我写一套幻灯片”。

谁适合使用 marp-slide

如果你符合以下情况，适合用 marp-slide：

• 经常根据笔记、大纲或会议内容制作 slide deck
• 需要的是兼容 Marp 的 markdown，而不是只能在 PowerPoint 里用的输出
• 希望整体视觉更统一，但又不想手工设计 CSS
• 常常会让智能体“做得更好看一点”，并且希望这个需求能落到具体工作流上

最匹配的实际任务

真正要解决的问题，不是“生成几页 bullet points”，而是：选一个合适的主题、把幻灯片结构组织得更适合展示，并输出接近可直接渲染的 Marp markdown。如果你想快速从想法走到 deck，又不想自己临时查 Marp 语法、图片布局方式和主题样式，这一点尤其重要。

marp-slide 和普通提示词有什么不同

和普通 prompt 相比，marp-slide 提供的是：

• 7 种内置视觉方向：default、minimal、colorful、dark、gradient、tech、business
• 可在 assets/ 中直接复用的模板文件
• 涵盖 Marp 语法、图片布局、主题选择、高级功能和 CSS 定制的参考文档
• 一套对模糊需求也更有约束力的工作流，比如“做得专业一点”或“做得酷一点”

安装前用户最关心什么

决定要不要用，核心其实就几个问题：

• 它比从零写 prompt 更省时间吗？通常是的，尤其是在你明确需要 Marp 输出时。
• 灵活吗？在主题选择和 deck 起草上很灵活；但如果你追求高度定制的品牌系统，灵活度会下降。
• 对新手友好吗？大体友好，因为模板和参考资料能大幅减少对 Marp 细节的猜测。
• 适合所有演示格式吗？不适合。它最强的场景，仍然是目标输出为 Marp markdown。

如何使用 marp-slide 技能

marp-slide 的安装上下文

如果你的智能体环境支持安装 Skills，常见的工具链方式是：

npx skills add softaworks/agent-toolkit --skill marp-slide

如果你的环境不使用这个安装器，也可以直接打开仓库里的 skills/marp-slide 目录，把其中的文件当作工作参考。关键点在于：只有当智能体能同时读取 SKILL.md 以及配套的 assets/ 和 references/ 文件时，marp-slide 的价值才会真正体现出来。

先读这些文件

想最快上手，建议按这个顺序看：

1. SKILL.md
2. references/marp-syntax.md
3. references/theme-selection.md
4. 与你场景对应的 assets/template-*.md
5. 如果视觉表达很重要，再看 references/image-patterns.md
6. 如果需要自定义，再看 references/advanced-features.md 和 references/theme-css-guide.md

这个阅读路径能让你以最少的仓库摸索，获得最多的有效信息。

marp-slide 需要什么输入

marp-slide 在以下信息齐全时效果最好：

• 受众：高管、学生、工程师、客户
• 目标：说服、解释、教学、汇报进展
• deck 长度：目标页数或时间限制
• 源材料：笔记、要点列表、文档摘录、会议总结
• 语气：正式、技术型、极简、偏有活力
• 视觉偏好：主题、浅色/深色、偏图像还是偏文字
• 输出限制：纯 Marp markdown，是否需要 speaker notes

如果你只说一句“做一套幻灯片”，技能当然也能起草，但主题选择和每页信息密度就只能靠猜。

如何把模糊需求改写成更强的 marp-slide 提示词

弱提示词：

• “Create slides about our API migration.”

更强的提示词：

• “Use marp-slide to create a 10-slide Marp deck for engineering managers about our API migration. Audience knows the old system but not the rollout plan. Use the tech theme, keep slides concise, include one architecture slide, one risk slide, and one migration timeline slide. Optimize for a 12-minute internal presentation.”

这种写法能给技能足够的上下文，从而更准确地决定结构、信息密度和主题风格。

主题选择会怎样实际影响输出

主题的选择对可读性和适配度的影响，通常比用户预期更大：

• tech：适合工程、产品架构、开发者分享
• business：适合季度复盘、提案、面向客户的内部报告
• minimal：适合学术、工作坊、文档型 deck
• colorful 或 gradient：适合活动、创意、宣传、语气更轻快的场景
• dark：适合暗场演示，或需要更高视觉对比时
• default：当需求范围很宽或还不确定时，是更稳妥的选择

如果你对“风格语言”本身并不敏感，优先按受众来选，而不是按个人喜好来选。

不要从空白页开始，先用模板

一个更实际的 marp-slide 工作方式，是先打开 assets/ 中最接近的模板再改：

• assets/template-business.md
• assets/template-tech.md
• assets/template-minimal.md
• assets/template-dark.md
• assets/template-colorful.md
• assets/template-gradient.md
• assets/template-basic.md

这比让智能体从零发明一套格式更好，因为这些模板本身已经包含了布局、字排、间距等关键决策。

适合真实做幻灯片的工作流建议

一套更可靠的使用流程是：

1. 先选主题
2. 提炼信息主线和受众
3. 先起草幻灯片大纲
4. 再把每页扩展成 Marp markdown
5. 只在确实有助于理解时添加图片或图表
6. 渲染后再删减文字过密的页面
7. 只有当整体结构已经成立时，才去定制 CSS

这个顺序能避开一个常见失误：在幻灯片逻辑还没站稳之前，就把时间花在样式上。

哪些做法能明显提升 deck 质量

如果你想让 marp-slide 输出更好，以下做法很有效：

• 当需求本身比较乱时，先让它给你 slide outline，再写完整内容
• 如果你想要更适合演示的 deck，明确写出“每页最多 3–5 个 bullet”
• 直接指出哪些页应该以视觉表达为主，而不只是“多放点图”
• 如果你需要 title slide 和 closing slide，要明确说出来
• 给出演讲时长；它会直接影响页数和信息密度

和泛泛地写一句“专业一点”相比，这些输入更能改善第一稿质量。

什么时候该用这些 Marp 参考资料

这些参考文件不只是背景资料，它们能直接解决常见卡点：

• references/marp-syntax.md：基础写法和 directives
• references/image-patterns.md：图片摆放方式与官方 Marpit 模式
• references/best-practices.md：页面信息密度和结构建议
• references/advanced-features.md：更复杂的布局与效果
• references/theme-css-guide.md：自定义 CSS 调整
• references/official-themes.md：更完整的 Marp 主题背景

当你的目标不只是“看起来像 markdown 写得还行”，而是要真正渲染干净、输出可用 时，就该用这些参考资料。

marp-slide 使用示例提示词

你可以这样调用这个技能：

“Use marp-slide to create a Marp deck from these notes. Audience: startup investors. Goal: explain product traction and funding use. Length: 8 slides. Theme: business. Include a strong lead slide, one market slide, one traction slide, one roadmap slide, and a closing ask. Keep each slide presentation-friendly, not document-heavy.”

这个 prompt 足够具体，能触发技能的核心价值，同时又没有把草稿限制得过死。

marp-slide 技能常见问题

marp-slide 比普通的写幻灯片 prompt 更好吗？

如果你明确需要 Marp 输出，通常是更好的。普通 prompt 也许能给出还不错的 slide 文案，但 marp-slide 额外提供了主题选择、可复用模板、Marp 专用格式参考，以及更扎实的默认工作流。

marp-slide 只适合开发者吗？

不是。仓库里包含了面向商务、学术和创意场景的主题。它底层确实有技术属性，因为 Marp 本身是基于 markdown 的，但实际适用范围并不局限于开发者演讲。

新手能用 marp-slide 吗？

可以，尤其是跟着模板用时更容易上手。最简单的路径是：选一个最接近的主题，提供受众和目标，然后让智能体先起一份简短 deck。你不需要非常懂 Marp，也能从中获得价值。

什么情况下 marp-slide 不适合？

如果有以下需求，就不建议用 marp-slide：

• 你需要以 PowerPoint 为原生工作流，并且包含大量手工动画
• 品牌规范要求使用这里没有覆盖到的企业级定制模板
• 你的输出本质上是一篇长报告，而不是一套幻灯片
• 你根本不打算使用 Marp 或 markdown

marp-slide 能处理自定义样式吗？

能处理一部分。内置的 CSS 主题已经覆盖了很多常见需求，而 references/theme-css-guide.md 也能帮助你继续改。但如果你要的是完整 bespoke 的设计系统，那就要预期在基础技能之外再做更多编辑。

marp-slide 适合图片很多的 deck 吗？

适合，但前提是你要把图片意图说清楚。技能里包含 references/image-patterns.md，这很重要，因为 Marp 里的图片布局对语法比较敏感。如果视觉内容是核心，就要明确哪些页放图、图片起什么作用，而不是只说“做得更有视觉感”。

如何改进 marp-slide 技能的使用效果

先给更好的源材料

提升质量最有效的方式，通常不是多加几个形容词，而是给出更好的输入。高质量源材料包括：

• 带优先级的粗略大纲
• 按主题分组的原始笔记
• 需要压缩成幻灯片的文档段落
• 目标页数和演讲时长
• 你希望它参考的 deck 示例

如果只是把杂乱内容一股脑丢进去，智能体就只能自己猜叙事主线。

明确受众，以及你希望他们做出什么判断

一份强的 marp-slide brief，应该说清楚受众在看完 deck 后要理解什么、或者做什么。比如：

• 批准某个迁移方案
• 理解一项研究发现
• 在多个选项之间做选择
• 记住某些教学重点

这样智能体才更容易判断：哪些内容值得单独成页，哪些内容应该删掉。

避免第一稿就变成“字墙”

一个很常见的失败模式，就是每页塞太多字。要改善 marp-slide 输出，可以明确要求：

• 每页更少的 bullets
• 更短的标题
• 把信息过密的主题拆成两页
• 一页只表达一个核心信息
• 用更适合演讲的措辞，而不是文档式长段落

如果你的源材料本身是 memo 或 transcript，这一点尤其重要。

在改 CSS 之前，先选对模板

很多人太早跳进 theme CSS。更合理的做法是：

1. 先选最接近的模板
2. 先验证整体结构和可读性
3. 之后如果有必要，再微调颜色、间距或字体

如果 deck 的结构本身就弱，CSS 再怎么改也救不回来。

用有针对性的修改指令来迭代

拿到第一稿后，不要只丢一句“improve this”。更好的修订提示词例如：

• “Reduce slide 4 to three bullets and add a clearer takeaway.”
• “Convert slides 5 and 6 into a problem/solution pair.”
• “Switch from default to business and tighten the tone for executives.”
• “Add one image-friendly slide using Marp-compatible layout patterns.”

这种定向修改，比笼统地要求“风格再好一点”更容易得到高质量第二稿。

把仓库参考文件当作质量检查清单

改进 marp-slide 结果的一个实用方法，是把这些参考文件当作出稿后的检查表：

• 语法是否有效：references/marp-syntax.md
• 图片是否正确：references/image-patterns.md
• 设计是否更成熟：references/best-practices.md
• 是否需要更深度的定制：references/advanced-features.md 和 references/theme-css-guide.md

这样一来，它就不再只是“一次性 prompt”，而会变成一套可重复使用的幻灯片工作流。

了解 marp-slide 的核心取舍

marp-slide 的优势，是能快速产出“足够可信、可以继续推进”的 Marp deck。它的取舍在于：整个能力是围绕 Marp 的结构方式和内置主题展开的，带有比较明确的默认判断。如果你追求的是像素级、完全定制的演示设计，更适合把它当作高速起稿和结构整理工具，后续再继续定制，而不要期待第一版就达到最终品牌成品水准。