minorun-marp-skill

minorun-marp-skill 是一款面向 Marp 演讲幻灯片的 Agent Skill，专门帮助 AI 编程工具（Claude Code 等）生成专业级演讲 PPT。该技能将演讲幻灯片的制作拆解为三个核心维度：故事结构、图表设计、视觉平衡，并配有自动化检查脚本，确保 AI 生成的幻灯片在内容和形式上均达到可演示标准。

技能简介

minorun-marp-skill 是由日本技术博主 minorun365（@minorun365）开源的 Marp 幻灯片制作规范集。它不生成具体内容，而是告诉 AI 如何组织演讲的叙事结构、如何控制图表的信息密度、如何设计深色背景下的配色与留白，帮助 AI 生成的幻灯片从「格式整齐但内容空洞」进化为「有故事感、有视觉冲击力」的专业演示。

核心能力

该技能包含三大核心模块和配套工具：

• slide-story（故事结构）：定义演讲的抓取开头、中间扉页、阶段性披露、标题句式、收尾方式和时长估算规则
• slide-figures（图表设计）：规定图表信息量的筛选标准、SVG 绘制规范、文字最小尺寸、插图放置原则
• slide-design-dark（深色主题设计）：提供余白测量方法、垂直平衡技巧、深色背景配色方案、表格与代码块的排版规范，以及 Marp 常见陷阱提醒

配套工具包括：PDF 边距检查脚本、图文间距检查脚本、SVG 文字容纳检查脚本、版本对比脚本等。

安装配置

安装 Skill 文件

cp -r skills/* ~/.claude/skills/

安装主题与检查脚本

将 theme/ 和 tools/ 目录复制到幻灯片项目目录中。

安装依赖

npm install -g @marp-team/marp-cli
brew install poppler mupdf-tools  # macOS

使用步骤

1. 安装：将 skills 目录下的三个模块复制到 Claude Code 技能目录
2. 准备项目：将主题和工具脚本复制到幻灯片项目目录
3. 生成幻灯片：向 Claude Code 描述演讲主题和内容，让 AI 参考 skills 中的规范生成幻灯片
4. 导出 PDF：运行 marp --no-stdin deck.md --pdf --theme minorun-dark.css --allow-local-files
5. 运行检查脚本：python3 tools/check-dark-margins.py deck.pdf 等，验证边距、间距、图表文字是否符合规范
6. 修复问题：根据检查结果让 AI 调整幻灯片内容
7. 重复验证：直至所有检查脚本通过

适用场景

• 技术演讲与分享：开发者使用 Claude Code 制作技术分享 PPT，确保格式专业
• AI 辅助 PPT 制作：规范 AI 生成幻灯片的视觉质量
• 团队演示文档制作：统一团队内部的 PPT 制作标准
• 开源项目文档发布：为 GitHub 项目制作深色主题的演示幻灯片

适用人群

• 需要用 Claude Code 等 AI 工具制作演讲幻灯片的开发者
• 希望提升 AI 生成 PPT 视觉质量的演讲者
• 使用 Marp 进行演示文档编写的技术博主

工作原理

minorun-marp-skill 的核心思路是「将人的设计经验规则化、脚本化」。作者 minorun365 在长期制作演讲幻灯片的过程中，总结出一套 AI 能够理解和执行的规则体系，涵盖叙事结构、视觉设计和技术实现三个层面。AI 参考这些规则生成的幻灯片，配合检查脚本的客观验证，可以达到接近人工设计水平的演示效果。

官方链接

• GitHub：https://github.com/minorun365/minorun-marp-skill
• 作者 Twitter：https://x.com/minorun365