前言¶

做演示稿时，常见路径是：先有一份 Word、网页或会议纪要，再手工拆成「一页一个要点」。中间要删广告、补层级、想每页讲什么，还要对照下游工具要求的 Markdown 结构。若下游走 ppt-master 的 Strategist 管线，输入格式不对，后面改页和配图会反复返工。

下面介绍 SkillHub 上的 ppt-master文档助手（@user_633c893d/md-format，v2.1.0）：在 Agent 里把文档、网页或粘贴文本转成面向 ppt-master 的 Markdown，而不是从零手写幻灯大纲。

这是什么¶

ppt-master文档助手 是社区来源（community）的 Agent Skill，发布者为 user_633c893d，分类为 office-efficiency。它不直接生成 .pptx，而是把任意输入整理成 ppt-master 最优输入格式 的 Markdown：去噪、结构化精炼、YAML 意图声明、页级拆分和图表标注，输出面向 ppt-master 的 Strategist 管线。

标签 requires_api_key=false，安装后无需额外 API Key 即可按 Skill 说明使用。

SkillHub 页面显示：评分 100000，累计下载 19394 次（截至页面展示数据）。

核心功能¶

依据官方简介，Skill 在 Agent 侧完成以下处理（均针对「给 ppt-master 用的 Markdown」）：

1. 输入多样：支持文档、网页文章或用户粘贴的纯文本。
2. 去噪与精炼：去掉与演示无关的噪声，保留可讲的主线信息。
3. 结构化：把长文整理成层次清晰的 Markdown，便于后续按页编排。
4. YAML 意图声明：在输出中附带 YAML，声明演示意图（具体字段以安装后的 SKILL.md 为准）。
5. 页级拆分：按幻灯页粒度切分内容，而不是一整段长文。
6. 图表标注：对适合可视化的位置做标注，方便 Strategist 后续处理图表需求。

在对话中可用官方给出的触发词唤起，例如：生成PPT素材、提炼成PPT、文档转PPT、转为幻灯格式、doc-to-slides。

安装与启用¶

官方页面要求按 SkillHub 安装文档操作，并安装坐标 @user_633c893d/md-format。

1. 检查或安装 SkillHub CLI¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

若未安装，可使用 SkillHub 文档中的推荐方式（完整安装 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装到当前 Agent 的 skills 目录¶

安装 Skill 时必须用 --dir 指向当前 Agent 识别的 skills 目录；装到默认 ./skills/ 可能不会被 Agent 加载。

skillhub install @user_633c893d/md-format --dir <你的 Agent skills 目录>

常见路径示例（以 SkillHub 安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

对应 Cursor 可写成：

skillhub install @user_633c893d/md-format --dir ~/.cursor/skills/

安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。也可将官方安装说明发给 AI，让其按文档完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_633c893d/md-format。

典型用法¶

官方未单独给出逐步截图示例，可复现的用法如下。

1. 确认 Skill 已出现在当前 Agent 的 skills 目录并完成加载。
2. 在对话中提供材料：上传文档、给出网页 URL，或直接粘贴正文。
3. 使用触发词说明目标，例如：「文档转PPT，按 ppt-master 格式输出」或「提炼成PPT 素材」。
4. 检查 Agent 输出的 Markdown：是否包含 YAML 意图块、是否已按页拆分、是否对图表位置有标注。
5. 将输出作为 ppt-master Strategist 管线的输入，继续生成或调整幻灯。

若输出结构与预期不符，可在同一会话中补充约束（页数、受众、必须保留的章节），让 Agent 在 Skill 规则下重新整理。

适用场景与注意¶

适合谁

• 已有 ppt-master 工作流，希望把「长文 → Strategist 输入」交给 Agent 标准化。
• 经常从报告、博客、会议纪要做汇报，需要先去噪再分页，而不是手工复制粘贴。

注意

• 本 Skill 产出的是 Markdown 素材，不替代 ppt-master 本身的渲染与 Strategist 后续步骤；两端格式要对齐，以 Skill 说明与 ppt-master 文档为准。
• 网页与长文档的真实内容以你提供的来源为准；Agent 可能漏删噪声或误拆页，交付前建议人工过一遍页级大纲与 YAML 意图。
• 安装路径错误是常见坑：务必 --dir 到当前客户端的 skills 目录。
• 评分与下载量来自 SkillHub 页面展示，会随时间变化，以安装前页面为准。

结尾¶

ppt-master文档助手 把「文档 / 网页 / 粘贴文本 → 去噪、结构化、YAML、分页、图表标注」收敛成一条 Agent 指令，减少为 Strategist 手写输入格式的时间。需要安装或查看版本时，以 SkillHub 为准：

• Skill 页面：https://www.skillhub.cn/skills/user_633c893d/md-format
• 安装说明：https://skillhub.cn/install/skillhub.md
• 坐标：@user_633c893d/md-format（v2.1.0）