前言¶
把 PPT 做成可发布的演讲视频，常见做法是导出每页图、单独录旁白、再在剪辑软件里对齐时间轴和字幕。步骤多、改稿成本高，也很难在 Agent 对话里用一句话跑通整条链路。
下面介绍 SkillHub 上的 ppt-to-video（@user_460920f7/ppt-to-video，版本 1.0.0，来源 community，发布者 user_460920f7）。它在 Agent 侧把「幻灯片 + 文稿 + 音色」收敛成一条可触发的生成流程，输出带旁白且字幕同步的完整演示视频。
这是什么¶
ppt-to-video 归类为 design-media。按官方说明，它接收三类输入：PDF 格式的演示幻灯片、演讲稿文稿，以及参考人声；输出为完整的旁白演示视频，并生成与时间轴同步的字幕。
适用时机是：需要从 PPT/PDF 幻灯片生成演示视频，并希望结合声音克隆、文本转语音（TTS）与字幕生成。页面标注 requires_api_key=false，表示该 Skill 本身不要求在 Skill 配置里填写 API Key（具体运行环境若调用外部语音服务，仍以实际依赖为准）。
核心功能¶
以下能力均来自 SkillHub 页面与 API 资料中的简介，不展开未公开的实现细节。
- 幻灯片输入：以 PDF 演示稿为幻灯片载体（官方表述为 PDF presentation slides；若手头是 PPT，需先导出为 PDF 再交给 Skill）。
- 文稿驱动旁白：使用用户提供的演讲稿（speech manuscript）作为解说文本来源。
- 参考音色：支持基于参考人声（reference voice）做声音相关处理（简介中明确包含 voice cloning 与 text-to-speech）。
- 成片输出：生成完整旁白演示视频，并附带同步字幕（synchronized subtitles）。
Agent 可在用户提到下列意图时自动考虑启用该 Skill，官方给出的触发表述包括：PPT to video、generate presentation video、slides to video、演讲视频、PPT转视频、幻灯片生成视频、voice cloning presentation，以及任何「把幻灯片转成带语音合成旁白的视频」类请求。
安装与启用¶
Skill 基于通用 SKILL.md 格式分发。在 SkillHub 上安装时，官方提供两种方式：让 AI 按安装文档操作，或使用 skillhub CLI。
方式一：提示 Agent 安装¶
将下面意图发给当前 AI（Cursor、Claude Code 等支持 Skills 的客户端均可按各自 skills 目录落盘）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_460920f7/ppt-to-video`。
方式二：skillhub CLI¶
先确认本机是否已有 CLI（摘自 SkillHub 安装文档）：
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档推荐）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令形如：
skillhub install @user_460920f7/ppt-to-video --dir <你的 skills 目录>
也可先搜索再安装：
skillhub search ppt-to-video
skillhub install @user_460920f7/ppt-to-video --dir <你的 skills 目录>
安装后按所用客户端说明刷新或重启 Agent，使新 Skill 被加载。
典型用法¶
公开资料未附带逐步命令行示例；可复现的用法是：在已安装 Skill 的会话中，准备好 PDF 幻灯片、讲稿全文和参考音频，用自然语言说明要生成演示视频。例如：
用 ppt-to-video：这份 PDF 是幻灯片，attached 是演讲稿，reference.wav 是主讲音色参考，请生成带同步字幕的演讲视频。
或直接使用官方列出的中文触发语：
把这份 PDF 幻灯片和讲稿做成 PPT转视频，旁白用参考音频里的声音，并生成字幕。
Agent 会按 SKILL.md 中的流程调用工具与脚本；具体参数与中间产物路径以安装后的 Skill 文档为准。
适用场景与注意¶
适合谁
- 需要把培训课、路演、内部分享的幻灯片快速变成可传播的旁白视频，且希望字幕与解说一致。
- 希望在对话里完成「素材准备 → 合成 → 字幕」，而不是手工剪辑时间轴。
使用上需注意
- 幻灯片侧官方写的是 PDF，不是直接上传
.pptx；导出 PDF 后再交给 Skill 更稳妥。 - 三类输入缺一不可：PDF 幻灯片、讲稿、参考人声；缺任一项时，应先补齐再发起生成。
- SkillHub 统计（截至页面展示）：评分 100000，下载 8169，安装 116；社区来源 Skill，升级与行为变更以 SkillHub 上 v1.0.0 页面为准。
- 生成质量与耗时取决于运行环境与 Skill 内部调用的语音/视频能力；公开简介未承诺具体分辨率、语种或时长上限，落地前建议用短稿试跑一页幻灯片。
结尾¶
ppt-to-video 把 PDF 幻灯片、演讲稿和参考音色串成「旁白 + 同步字幕」的演示视频生成任务，适合在 Agent 里用自然语言触发。安装与坐标以 SkillHub 为准：
- 页面：https://www.skillhub.cn/skills/user_460920f7/ppt-to-video
- API 条目：https://api.skillhub.cn/user_460920f7/ppt-to-video
经过上面的步骤装好 Skill 后，用官方触发语或明确的三类素材说明需求，即可在对话中启动生成流程。
