前言¶

做内容归档、会议纪要或二次创作时，经常要把视频里的语音变成可检索的文本。手工听写成本高；只抄平台自带字幕又可能缺字段、缺时间轴，或根本没有 CC。若希望 Agent 按统一流程处理「任意 URL → 带时间戳与元信息的文字稿」，需要一套不绑定单一平台的 Skill 方法。下面介绍 SkillHub 上的 Video Transcript Method（@efficient-technology/video-transcript-method）。

这是什么¶

Video Transcript Method 是面向「视频语音 → 结构化文字稿」的通用 Skill 方法：从视频 URL 出发，经解析、音轨或字幕获取、识别与分段，输出带时间戳、元信息与要点总结的文字稿。发布方为效享网络，在 SkillHub 分类为 data-analysis，当前版本 1.0.1，来源标注为 enterprise。页面标签标明 requires_api_key=false，即不强制依赖额外 API Key 配置（具体运行环境仍可能需要本地工具或模型，以 Skill 内说明为准）。

核心功能¶

以下能力均来自官方简介，未单独列出的细节不作延伸：

1. 视频 URL 解析：从在线视频地址进入处理流程，不绑定特定视频平台。
2. 音频提取：在需要走语音识别路径时，从视频中取得音轨。
3. CC 字幕检测：优先识别是否已有封闭字幕，可走字幕路径减少误识别成本。
4. Whisper 语音识别：无可用字幕时，用 Whisper 做语音转录。
5. 元信息获取：与文字稿一并整理视频相关元数据。
6. 语义分段：按语义切分文稿，便于阅读与引用。
7. 结构化输出：产出带时间戳、元信息与要点总结的文字稿。

在对话中可用触发词唤起，例如：视频文字稿、视频转文字、字幕提取、语音转录，以及简介中截断的 vid... 等表述。

安装与启用¶

安装前需具备 SkillHub CLI。若尚未安装，可先检查版本：

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

安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。官方页面给出的安装提示为：参照 SkillHub 安装与优先源配置，安装坐标 @efficient-technology/video-transcript-method。

命令形式与 SkillHub 文档一致，将搜索关键词替换为完整坐标即可，例如：

skillhub install efficient-technology/video-transcript-method --dir <skills 目录>

常用客户端 skills 目录（摘自官方安装文档）：

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

装到对应目录后，按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录路径；安装命令本身相同，核实不到的客户端专用配置项本文不写。

典型用法¶

公开页面未提供固定 CLI 子命令或示例 JSON 输出，典型用法是：在已启用该 Skill 的 Agent 对话中，给出在线视频 URL，并用触发词说明需求（如「提取视频文字稿」「字幕提取」）。Agent 按 Skill 内定义的全流程执行：解析 URL → 检测 CC → 必要时提取音频并用 Whisper 转录 → 拉取元信息 → 语义分段 → 返回结构化文字稿。

复现步骤可归纳为：

1. 按上一节将 @efficient-technology/video-transcript-method 安装到当前 Agent 的 skills 目录。
2. 打开 Cursor（或其他已配置目录的客户端），新建对话。
3. 发送包含视频链接与意图的提示，例如说明需要带时间戳的文字稿与要点总结。
4. 根据 Agent 返回的文稿做校对；涉及版权与平台条款时，自行确认是否允许下载与转录。

适用场景与注意¶

适合谁：需要把多平台在线视频统一转成可引用文稿的数据分析、内容运营、研发文档归档等角色；希望 Agent 走「字幕优先、Whisper 兜底」而不是手写平台爬虫脚本时。

限制与注意：

• 方法通用，但具体 URL 是否可解析、是否受 DRM 或登录限制，取决于视频源与运行环境，官方简介未承诺全站兼容。
• Whisper 与音轨提取对算力、依赖和网络有要求；长视频耗时会明显增加。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 921；与用户线索中的数字不一致时，以 SkillHub 页面与 enterprise 源信息为准。
• 转录内容可能含错误，要点总结为辅助阅读，重要场合应人工复核。

结尾¶

Video Transcript Method 把「URL → 结构化视频文字稿」收成一条可复用的 Agent Skill 流程：时间戳、元信息与要点总结一并输出，并覆盖 CC 检测与 Whisper 转录等环节。安装与坐标以 SkillHub 为准。

• SkillHub 页面：https://www.skillhub.cn/skills/efficient-technology/video-transcript-method
• API 条目：https://api.skillhub.cn/efficient-technology/video-transcript-method
• 安装说明：https://skillhub.cn/install/skillhub.md