marp-slides-creator
专业Marp演示文稿制作助手。支持完整工作流程:工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅(中文演示文稿)、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation assistant with complete workflow: workspace initialization, content analysis, slide creation, multi-d…
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill marp-slides-creatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of marp-slides-creator
marp-slides-creator scores 95/100 on our quality scale, 317th of 2,780 Automation skills we index (top 12%).
Its SKILL.md is 16 KB long, well organised into 82 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so marp-slides-creator is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
marp-slides-creator compared with similar skills
All 4 of these similar skills score higher than marp-slides-creator; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| marp-slides-creator (this skill)by brycewang-stanford | 95 | 4.4k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install marp-slides-creator?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill marp-slides-creator. The install tabs above show the steps for each supported agent. - Which AI agents does marp-slides-creator work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is marp-slides-creator safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is marp-slides-creator still maintained?
- The repository was last updated about 2 months ago, so marp-slides-creator is actively maintained.
Skill content
View source on GitHubname: marp-slides-creator description: '专业Marp演示文稿制作助手。支持完整工作流程:工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅(中文演示文稿)、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation assistant with complete workflow: workspace initialization, content analysis, slide creation, multi-dimensional review, Chinese language review (for Chinese presentations), PNG conversion check, and finalization. All outputs organized in project workspace.' allowed-tools: Read, Write, Edit, Bash, Task, Glob
Marp Slides 制作助手
技能概述
本技能提供系统性多阶段Marp演示文稿制作流程,从工作空间初始化到终稿输出。对于中文演示文稿,额外包含中文语言规范审阅阶段。所有分析报告、初稿、审阅文档、PNG导出和终稿统一保存在项目工作文件夹中,便于管理和追溯。
支持多种主题风格:内置 14 款精选主题,涵盖学术、商务、创意等场景。详见 themes/README.md。
核心原则
Slides设计原则
| 原则 | 说明 | 要点 | |------|------|------| | 一页一点 | 每页只讲一个核心观点 | 避免信息过载 | | 视觉层次 | 标题→要点→细节 | 使用粗体、列表、引用区分 | | 留白充足 | 内容不超过页面60% | 给观众呼吸空间 | | 文字精简 | 每页文字不超过8行 | 关键词优于完整句子 |
内容密度控制
- 标题页:主标题 + 副标题 + 作者信息
- 内容页:标题 + 3-5个要点(每点1-2行)
- 对比页:两栏对比,每栏不超过4点
- 总结页:3-5个核心要点
七阶段工作流程
严格按照以下流程执行,每阶段结束后询问用户确认:
阶段零:工作空间初始化与主题选择(预处理)
触发:用户请求制作slides时立即执行
执行步骤:
-
确定项目名称:
- 根据用户提供的主题/文件名确定项目名称
- 使用简短的英文或拼音命名,用连字符连接
- 示例:
academic-writing、ai-introduction、product-launch
-
创建工作文件夹结构:
# 创建主工作文件夹和子目录 mkdir -p slides_[项目名]/{01_analysis,02_drafts,03_reviews,04_exports,05_final} -
文件夹结构说明:
slides_[项目名]/ ├── 01_analysis/ # 阶段一:分析报告 │ ├── content-analysis.md # 内容分析报告 │ └── outline.md # Slides大纲 ├── 02_drafts/ # 阶段二:初稿 │ └── presentation.md # Slides初稿 ├── 03_reviews/ # 阶段三:审阅报告 │ ├── content-review.md # 内容审阅 │ ├── format-review.md # 格式审阅 │ ├── density-review.md # 密度审阅 │ ├── visual-review.md # 视觉审阅 │ ├── chinese-review.md # 中文规范审阅(仅中文) │ └── summary.md # 综合审阅报告 ├── 04_exports/ # 阶段四:PNG/HTML导出 │ ├── slide_001.png │ ├── slide_002.png │ └── slides.html ├── 05_final/ # 阶段五:终稿 │ ├── presentation.md # 最终Markdown │ ├── slides.html # HTML版本 │ └── slides.pdf # PDF版本(可选) └── README.md # 项目说明文件 -
主题选择:
使用 AskUserQuestion 工具让用户选择主题风格:
questions: - question: "请选择演示文稿的主题风格" header: "主题风格" multiSelect: false options: - label: "academic (学术风格)" description: "适合学术报告、论文答辩,maroon红色标题栏" - label: "beam (Beamer风格)" description: "仿LaTeX Beamer,适合学术演讲、技术研讨" - label: "jobs (乔布斯风格)" description: "Apple发布会风格,适合产品发布、商业演示" - label: "graph_paper (方格纸风格)" description: "技术分享、教学演示,手写笔记感"可用主题列表(按场景分类):
| 场景 | 主题选项 | |------|----------| | 学术答辩 | academic, beam, zju | | 技术分享 | graph_paper, beam, turing | | 产品发布 | jobs, gradient | | 企业汇报 | companyLightBlue, companySZ | | 教学演示 | simple, graph_paper, academic | | 创意展示 | gradient, jobs, socrates |
主题文件位置:
themes/目录下所有.css文件 -
创建README.md:
# [项目名] Slides ## 项目信息 - 创建时间:[日期] - 输入材料:[原始文件名] - 主题:[主题描述] - **使用主题**:[选择的主题名称,如 academic/beam/jobs 等] ## 文件夹说明 - `01_analysis/` - 内容分析和大纲 - `02_drafts/` - Slides初稿 - `03_reviews/` - 审阅报告 - `04_exports/` - PNG和HTML导出 - `05_final/` - 最终版本 ## 制作进度 - [ ] 阶段零:工作空间初始化 - [ ] 阶段一:内容分析 - [ ] 阶段二:初稿制作 - [ ] 阶段三:多维度审阅 - [ ] 阶段三B:中文语言规范审阅(仅中文演示文稿) - [ ] 阶段四:PNG转换检查 - [ ] 阶段五:问题修复与终稿
输出:工作文件夹路径、选择的主题名称,告知用户所有产出物将保存在此文件夹中
阶段一:内容分析与消化
触发:工作空间创建完成后,用户提供输入文件(PDF、论文、文档、笔记等)
执行步骤:
- 初步阅读:使用 Read 工具读取输入文件,了解整体结构
- 深度分析:
- 提取核心论点和关键信息
- 识别逻辑结构(问题-方案-结论 / 现状-分析-建议 等)
- 标记重要数据、引用、案例
- 内容分类:
- 核心观点(必须包含)
- 支撑证据(选择性包含)
- 背景信息(简化或省略)
- 大纲生成:
- 确定slides数量(建议10-20页)
- 规划每页主题和内容密度
- 设计叙事流程
文件保存:
- 内容分析报告:
slides_[项目名]/01_analysis/content-analysis.md - Slides大纲:
slides_[项目名]/01_analysis/outline.md
输出模板:
01_analysis/content-analysis.md:
## 内容分析报告
### 文档概述
- 主题:[主题]
- 类型:[论文/报告/教程/...]
- 核心论点:[1-2句话]
### 关键内容提取
1. [关键点1]
2. [关键点2]
...
01_analysis/outline.md:
## Slides大纲(预计X页)
1. 标题页
2. [内容页标题]
3. ...
阶段二:Slides初稿制作
触发:用户确认内容分析和大纲
执行步骤:
-
读取模板:使用 Read 工具读取
marp-template.md -
应用主题:
- 在 YAML frontmatter 中设置用户选择的主题:
--- marp: true theme: [用户选择的主题名] --- - 不同主题可能支持特殊的 class,参考
themes/README.md
- 在 YAML frontmatter 中设置用户选择的主题:
-
主题适配(自动调整):
不同主题对标题格式有不同要求,制作 slides 时必须根据主题自动调整:
| 主题 | 内容页标题格式 | 说明 | |------|----------------|------| | beam |
#(h1) | h1 显示在顶部蓝色条中 | | academic |#(h1) | h1 用于页面标题 | | jobs |#(h1) | h1 有特殊下划线样式 | | graph_paper |##(h2) | 标准 h2 标题 | | simple |##(h2) | 标准 h2 标题 | | 其他主题 |##(h2) | 默认使用 h2 |beam 主题特殊处理:
- 每页第一个
#(h1) 会自动显示在顶部蓝色装饰条中 - 标题页使用
<!-- _class: title -->指令 - 内容页直接使用
#标题(不是##) - 示例:
--- # 页面标题在蓝色条中 正文内容...
academic/jobs 主题特殊处理:
- 同样使用
#(h1) 作为页面标题 - 支持
class: lead用于特殊页面
- 每页第一个
-
必须包含居中样式:frontmatter 的
style中必须包含以下 CSS,否则图片和表格会左对齐:/* 图片居中 */ img { display: block !important; margin: 0 auto !important; } /* 表格居中(覆盖主题的 width:100% 和 display:block) */ section table { display: table !important; width: auto !important; margin-left: auto !important; margin-right: auto !important; }原因:Marp 基础 CSS 设置
section table { display: block; width: max-content },多数自定义主题又设置table { width: 100% },两者都会导致表格无法居中。必须用!important同时覆盖display、width和margin三个属性才能生效。marp-template.md已包含这些样式。 -
修改Header/Footer:根据演讲主题调整
-
逐页制作:
- 遵循模板中的页面类型和格式
- 每页严格控制内容量
- 使用适当的Markdown格式(粗体、引用、列表)
页面类型选择(参考 references/slide-types.md):
- 标题页:开场
- 目录页:内容预告
- 单点页:核心观点展示
- 列表页:多要点展示
- 对比页:两种观点/方案对比
- 引用页:重要引用展示
- 分隔页:章节过渡
- 总结页:要点回顾
文件保存:
- 保存初稿:
slides_[项目名]/02_drafts/presentation.md - 更新README.md中的进度状态
阶段三:多维度并行审阅
触发:初稿完成后自动进入
执行方式:使用 Task 工具并行派遣4个专业agent,每个负责一个审阅维度
并行Agent部署:
在单个消息中同时发起4个Task调用,设置 run_in_background=true:
Agent 1:内容审阅专家
Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:
你是一个内容审阅专家。请对比审阅slides内容。
## 输入材料
### 用户原始输入文件
[插入用户提供的原始文件内容]
### 用户的具体要求
[插入用户提出的要求和偏好]
### 制作的Slides初稿
[插入presentation.md内容]
## 审阅任务
1. **完整性检查**:
- 原始材料中的核心论点是否都已体现?
- 是否有重要信息被遗漏?
- 列出遗漏的关键内容
2. **准确性检查**:
- slides内容是否准确反映原始材料?
- 是否有曲解或过度简化?
- 数据和事实是否正确转述?
3. **用户要求符合度**:
- 是否满足用户提出的具体要求?
- 风格和重点是否符合用户期望?
- 列出未满足的要求
4. **逻辑流检查**:
- 叙事顺序是否合理?
- 各页之间过渡是否自然?
- 整体结构是否清晰?
## 输出格式
### 内容审阅报告
#### 完整性评估
- 评分:[A/B/C/D]
- 遗漏内容:[列表]
#### 准确性评估
- 评分:[A/B/C/D]
- 问题页面:[页码和问题描述]
#### 用户要求符合度
- 评分:[A/B/C/D]
- 未满足要求:[列表]
#### 逻辑流评估
- 评分:[A/B/C/D]
- 建议调整:[具体建议]
#### 需修改页面清单
| 页码 | 问题类型 | 问题描述 | 修改建议 |
|------|----------|----------|----------|
| ... | ... | ... | ... |
Agent 2:格式审阅专家
Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:
你是一个Marp格式审阅专家。请检查slides的格式规范性。
## Slides内容
[插入presentation.md内容]
## 审阅任务
1. **YAML Frontmatter检查**:
- marp: true 是否存在?
- theme 是否正确设置?
- header/footer 是否配置?
- style 块语法是否正确?
2. **分页符检查**:
- `---` 分页符是否正确使用?
- 是否有多余或缺失的分页符?
- 分页符前后是否有空行?
3. **Markdown语法检查**:
- 标题层级是否正确(#, ##, ###)?
- 列表格式是否统一?
- 粗体、斜体语法是否正确?
- 引用块语法是否正确?
- 代码块是否正确闭合?
4. **缩进和空行检查**:
- 缩进是否一致?
- 空行使用是否规范?
- 是否有多余的空白字符?
## 输出格式
### 格式审阅报告
#### 语法正确性
- 评分:[A/B/C/D]
- 语法错误:[列表,含行号]
#### 格式一致性
- 评分:[A/B/C/D]
- 不一致处:[列表]
#### 需修正项
| 行号 | 问题类型 | 原内容 | 建议修正 |
|------|----------|--------|----------|
| ... | ... | ... | ... |
Agent 3:密度审阅专家
Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:
你是一个slides内容密度审阅专家。请逐页检查内容密度。
## Slides内容
[插入presentation.md内容]
## 密度标准
| 指标 | 安全值 | 警告值 | 危险值 |
|------|--------|--------|--------|
| 每页文字行数 | ≤6行 | 7-8行 | >8行 |
| 每行字符数 | ≤35字符 | 36-45字符 | >45字符 |
| 列表项数量 | ≤5项 | 6项 | >6项 |
| 嵌套列表深度 | 1层 | 2层 | >2层 |
| 段落长度 | ≤2行 | 3行 | >3行 |
## 审阅任务
逐页分析:
1. 统计每页的文字行数
2. 检查最长行的字符数
3. 统计列表项数量
4. 检查是否有过长段落
5. 评估整体视觉密度
## 输出格式
### 密度审阅报告
#### 逐页密度分析
| 页码 | 行数 | 最长行 | 列表项 | 密度评级 | 状态 |
|------|------|--------|--------|----------|------|
| 1 | X | X字符 | X项 | 低/中/高 | ✓/⚠/✗ |
| 2 | ... | ... | ... | ... | ... |
#### 高密度页面(需处理)
- 第X页:[问题描述],建议:[拆分/精简/重组]
- ...
#### 拆分建议
对于需要拆分的页面,提供具体拆分方案:
- 第X页 → 拆分为 X-1 和 X-2
- X-1 内容:...
- X-2 内容:...
Agent 4:视觉审阅专家
Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:
你是一个slides视觉设计审阅专家。请检查视觉层次和设计规范。
## Slides内容
[插入presentation.md内容]
## 审阅任务
1. **标题层次检查**:
- 每页是否有清晰的标题?
- 标题层级使用是否合理?
- h1用于分隔页,h2用于内容页?
2. **强调元素检查**:
- 粗体是否用于关键词/要点?
- 引用块是否用于重要引语?
- 强调是否过度(全篇都是粗体)?
3. **视觉焦点检查**:
- 每页是否有明确的视觉焦点?
- 信息层次是否清晰?
- 是否有页面过于平淡或过于杂乱?
4. **一致性检查**:
- 相似内容的页面格式是否统一?
- 列表符号是否一致?
- 整体风格是否协调?
## 输出格式
### 视觉审阅报告
#### 标题层次
- 评分:[A/B/C/D]
- 问题页面:[列表]
#### 强调使用
- 评分:[A/B/C/D]
- 改进建议:[列表]
#### 视觉焦点
- 评分:[A/B/C/D]
- 需优化页面:[列表]
#### 一致性
- 评分:[A/B/C/D]
- 不一致处:[列表]
#### 需修改页面清单
| 页码 | 问题 | 建议 |
|------|------|------|
| ... | ... | ... |
汇总审阅结果:
使用 TaskOutput 工具收集4个agent的报告,整合为统一的审阅报告。
文件保存:
- 内容审阅报告:
slides_[项目名]/03_reviews/content-review.md - 格式审阅报告:
slides_[项目名]/03_reviews/format-review.md - 密度审阅报告:
slides_[项目名]/03_reviews/density-review.md - 视觉审阅报告:
slides_[项目名]/03_reviews/visual-review.md - 综合审阅报告:
slides_[项目名]/03_reviews/summary.md
综合审阅报告模板 (03_reviews/summary.md):
## 综合审阅报告
### 各维度评分
| 维度 | 评分 | 主要问题 |
|------|------|----------|
| 内容 | [A-D] | [概述] |
| 格式 | [A-D] | [概述] |
| 密度 | [A-D] | [概述] |
| 视觉 | [A-D] | [概述] |
### 需修改页面汇总
[按页码整合所有agent的修改建议]
### 优先处理项
1. [最重要的问题]
2. [次重要的问题]
...
输出:综合审阅报告,按优先级排列的修改清单
阶段三B:中文语言规范审阅(仅中文演示文稿)
触发:多维度审阅完成后,如果是中文演示文稿则执行此阶段
执行方式:使用 Task 工具派遣 subagent 执行
Subagent 调用指令:
使用 Task 工具,设置 subagent_type="general-purpose",prompt 内容如下:
你是一个中文语言规范专家。请对以下Marp Slides进行逐页审阅,确保符合中文书写规范和演示文稿语言习惯:
[插入 slides_[项目名]/02_drafts/presentation.md 的内容]
审阅要求:
1. **标点符号检查**:
- 必须使用中文标点:。,?!:;“” ‘’()……——
- 禁止使用英文标点:. , ? ! : ; ""'' () ... --
- 列表项末尾可省略句号
- 标题末尾不加标点
2. **引号使用规范**(重要):
- 原则:Slides中能不用引号就不用,让文字更简洁
- 删除不必要的引号,例如:
- ✗ 这就是所谓的"核心概念" → ✓ 这就是核心概念
- ✗ AI的"智能"表现 → ✓ AI的智能表现
- 仅在以下情况保留引号:
- 直接引语(如:他说:"……")
- 表示反讽或特殊含义
- 专有名词首次出现且需要解释
3. **语言习惯检查**:
- 避免欧化句式(如"被"字句滥用)
- 避免翻译腔
- 删除冗余表达(Slides需要极简文字)
- 使用自然的中文表达顺序
- 避免长句,每个要点保持简短
4. **中英文混排规范**:
- 中文与英文/数字之间加空格(如:Claude Code 是工具)
- 全角标点与英文之间不加空格
- 技术术语保持一致(如:API、SDK 等全文统一)
5. **Slides特有检查**:
- 标题是否简洁有力
- 要点是否用词精准
- 是否避免了口语化表达
- 专业术语是否一致
输出格式:
## 中文规范审阅报告
### 标点符号修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |
### 引号精简
| 页码 | 修改内容 |
|------|----------|
| ... | 删除"xxx"的引号 |
### 表达优化
| 页码 | 原表达 | 优化后 |
|------|--------|--------|
| ... | ... | ... |
### 中英文混排修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |
### 修正后的完整Slides
[输出完成所有修正的Slides内容]
文件保存:
- 中文规范审阅报告:
slides_[项目名]/03_reviews/chinese-review.md
后续处理:
- 收到 subagent 返回的审阅报告后,使用 Edit 工具将修正应用到
slides_[项目名]/02_drafts/presentation.md - 将修正后的Slides传递给阶段四
阶段四:PNG转换与并行检查
触发:审阅修改完成后
执行步骤:
-
转换为PNG:
# 从02_drafts读取初稿,导出到04_exports marp slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html marp slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/ -
并行部署Agents检查: 使用 Task 工具并行派遣多个 subagent,每个检查一组页面:
使用 Task 工具,设置
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
