前言¶
技术文档写在 Markdown 里便于维护，但对外宣讲、教程录制往往还要再录屏、配音、剪辑，成本高且难与文档同步更新。下面介绍 SkillHub 社区 Skill @user_9d080b9f/doc-to-video（v1.0.0）：在 Agent 侧按 SKILL 规范驱动，把 Markdown 技术文档转成带旁白的 1920×1080 视频，旁白用 edge-tts、画面用 Remotion、音画合并用 FFmpeg。
这是什么¶
一句话定位：面向「文档视频化」的 Agent Skill，把 Markdown 技术文档自动转成带配音旁白的全高清视频。
出品与坐标：社区来源（community），发布者 user_9d080b9f，SkillHub 分类为 design-media，坐标 @user_9d080b9f/doc-to-video。官方资料页：SkillHub 技能页；API 入口：https://api.skillhub.cn/user_9d080b9f/doc-to-video。
解决的问题：减少从 Markdown 到可发布教程视频之间的手工配音与剪辑步骤，把 TTS、视觉渲染、合成链路收敛到 Skill 所描述的工作流里。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，未在资料中出现的细节不展开。
- 输入：Markdown 技术文档（作为转换源）。
- 旁白：使用 edge-tts 生成自然人声配音。
- 画面：使用 Remotion 渲染视觉场景。
- 合成：使用 FFmpeg 合并音视频。
- 输出：1920×1080 全高清视频。
- 依赖 API Key：标签
requires_api_key=false，按页面说明不强制配置第三方 API Key。
SkillHub 上该 Skill 评分为 100000，下载 664 次（统计以页面展示为准，会随时间变化）。
安装与启用¶
Skill 遵循通用 SKILL.md 格式，需先安装 SkillHub CLI，再把技能装进当前 Agent 的 skills 目录，否则 Agent 无法加载。
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. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录（装到默认 ./skills/ 可能不会被识别）。常用路径如下（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将 <skills 目录> 换成上面对应路径）：
skillhub install @user_9d080b9f/doc-to-video --dir <skills 目录>
也可在对话里让 AI 按官方指引安装，SkillHub 页面给出的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_9d080b9f/doc-to-video`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
公开资料未附带逐步命令示例；实际步骤以安装包内的 SKILL.md 及 Agent 对话中的 Skill 指引为准。从简介可归纳的可复现目标如下：
- 准备一份 Markdown 技术文档（项目 README、教程章节等）。
- 在已启用该 Skill 的 Agent 中发起「将某 Markdown 转为带旁白的 1080p 视频」类任务，由 Skill 调度 edge-tts、Remotion、FFmpeg。
- 取得 1920×1080 的合成视频文件，用于项目文档视频化、教程制作或知识分享。
本地环境需能运行上述依赖（Node/Remotion 生态、FFmpeg、edge-tts 等）；具体前置条件以 Skill 内文档为准。
适用场景与注意¶
适合谁
- 维护 Markdown 文档、又需要配套讲解视频的团队或个人。
- 希望减少「写稿 → 录音 → 剪辑」重复劳动的教程作者。
限制与注意
- 社区 Skill（community），质量与维护节奏取决于发布者，升级前建议在 SkillHub 查看版本与说明。
- 流水线涉及 Remotion 与 FFmpeg，首次使用需确认本机或 CI 环境依赖齐全，否则合成阶段容易失败。
- edge-tts 依赖网络与语音服务可用性，离线或受限网络环境需自行评估。
- 公开页未声明
requires_api_key，但若你自行扩展脚本或接入其他服务，仍可能产生额外配置项；以SKILL.md为准。
结尾¶
@user_9d080b9f/doc-to-video 把 Markdown 文档、TTS 旁白、Remotion 画面和 FFmpeg 合成串成一条「文档到 1080p 视频」的 Agent 工作流，适合文档视频化与教程制作。安装与优先源配置见 https://skillhub.cn/install/skillhub.md；技能详情见 https://www.skillhub.cn/skills/user_9d080b9f/doc-to-video。
