前言¶
整理播客、访谈或课程视频时，常见流程是：先找下载方式，再换一款转写工具，最后把文本拷进笔记。若链接来自 YouTube、小宇宙或各类播客站，站点规则不一，云端转写还要考虑费用与隐私。下面介绍的 Skill 把「按 URL 取音频」和「语音转文字」收进 Agent 工作流里，转写依赖 Faster-Whisper，在本地完成，不需要配置云端语音识别 API（requires_api_key=false）。
这是什么¶
语音转文字（坐标 @user_03f2ab96/yuyinzhuanxie，版本 1.0.0）是 SkillHub 社区来源（community）的 Agent Skill，分类为 design-media，由发布者 user_03f2ab96 维护。
一句话定位：从任意可解析的 URL 下载音频，用 Faster-Whisper 转写成文本；整条链路可在本机跑完，不依赖云端转写 API。
官方页面：SkillHub - 语音转文字
API 入口：https://api.skillhub.cn/user_03f2ab96/yuyinzhuanxie
核心功能¶
以下能力均来自 SkillHub 上的官方简介，未在资料中出现的实现细节不作展开。
- URL 音频下载：支持从给定链接拉取音频；明确提到 YouTube、小宇宙（Xiaoyuzhoufm），以及 yt-dlp 能提取音频的任意站点（播客、视频页等）。
- 本地转录：使用 Faster-Whisper 将音频转为文本，全程本地运行（
Runs entirely locally — no cloud API needed）。 - 自然语言触发：当用户提出与转写相关的需求时，Agent 应启用该 Skill。官方列出的典型表述包括：
transcribe this audio、download and transcribe、speech to text、audio to text，以及中文 转录、语音转文字、音频转文字；也适用于把 YouTube、小宇宙、播客等音视频内容转成文字的任务。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按官方文档操作。
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/，Agent 可能识别不到。
skillhub install @user_03f2ab96/yuyinzhuanxie --dir <skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中示例：
skillhub install @user_03f2ab96/yuyinzhuanxie --dir ~/.cursor/skills/
3. 通过对话让 AI 安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_03f2ab96/yuyinzhuanxie`。
将上述内容发给支持 Skill 的 Agent 即可；Agent 应按该文档选择正确的 --dir 并完成安装。安装后若 Agent 要求重启或重新加载 skills，按其产品说明操作。
典型用法¶
公开资料未附带独立 CLI 手册，用法以「安装 Skill 后向 Agent 描述任务」为主，与官方简介中的触发场景一致。
- 确认
@user_03f2ab96/yuyinzhuanxie已装入当前 Agent 的 skills 目录。 - 在对话中给出可访问的音频或视频 URL，并说明需要转写，例如：
- 「请下载并转录这个链接的音频：https://…」
- 「把这个小宇宙节目的语音转成文字」
- 「speech to text，URL 是 …」 - Agent 按 Skill 指引完成下载（含 yt-dlp 支持的站点）与 Faster-Whisper 转录，将文本返回给你。
具体脚本路径、模型尺寸、语言参数等以 Skill 包内 SKILL.md 为准；若安装后行为与预期不符，可在 SkillHub 技能页查看版本 1.0.0 是否有更新说明。
适用场景与注意¶
适合谁
- 需要把 YouTube、小宇宙、播客 等链接内容快速变成文字稿，且希望转写在 本机 完成、避免上传音频到第三方 API 的场景。
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望用自然语言驱动「下载 + 转写」流水线的人。
使用上需注意
- 站点与版权：能否下载取决于 URL 与 yt-dlp 对该站的支持情况；请遵守内容提供方服务条款与著作权规定。
- 本地资源：Faster-Whisper 在本地推理，会占用 CPU/GPU 与磁盘；长音频耗时与机器配置相关，公开页面未给出性能指标，此处不臆测。
- 无需 API Key：标签为
requires_api_key=false，不依赖云端语音识别密钥；仍可能需要本机 Python 环境与 Skill 所声明的依赖（以安装后 Skill 文档为准）。 - 数据口径：SkillHub 页面显示评分 100000、下载 9907、安装 17（与部分聚合页上的下载/评分数字可能不一致，以 官方技能页 为准）。
结尾¶
语音转文字把「按 URL 取音频」和 Faster-Whisper 本地转写封装成 Agent Skill，适合播客、课程、访谈链接的一键转稿需求，且不需要云端转写 API。安装时记住坐标 @user_03f2ab96/yuyinzhuanxie 与正确的 --dir。
- 技能页：https://www.skillhub.cn/skills/user_03f2ab96/yuyinzhuanxie
- API：https://api.skillhub.cn/user_03f2ab96/yuyinzhuanxie
- 安装说明：https://skillhub.cn/install/skillhub.md
