跳到主要内容

YouTube Transcript 技能

先提取可用字幕;没有字幕时可选择语音转录。

社区 · michalparkola
作者michalparkola
许可证MIT
来源michalparkola/tapestry-skills · GitHub 上的 SKILL.md
适用于Claude Code · Codex、Gemini CLI、Cursor、Copilot
读取源文件日期

youtube-transcript 使用 yt-dlp 获取字幕。

优先人工字幕,其次自动字幕,Whisper 是可选的最后手段。

摘自该技能的 SKILL.md: # YouTube Transcript Downloader

这是 michalparkola 发布的社区技能,未经我们或 Anthropic 审核。技能可以让智能体运行代码、读取文件或访问网络。安装前请阅读它的 SKILL.md 和文件夹中的每个脚本,留意任何与其声称用途不符的内容。

功能

  1. 列出字幕、获取轨道,并可清理 VTT。

产出内容

  • 字幕文件或去重后的纯文本。

适用场景

  • 阅读或引用视频语音内容。

不适用的场景

  • 假设所有视频都有可访问字幕。

所需条件

  • 网络与 yt-dlp;语音转录可选用 Whisper、FFmpeg,并需模型存储空间。

技能包含的文件

文件或文件夹用途
SKILL.md字幕选择、备选转录及清理流程。

2026-11-16 在仓库中查到的许可证:MIT。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 获取这个视频的英语字幕。
  • 将这个 VTT 转成可读文本。
  • 下载前列出字幕语言。

如何安装 youtube-transcript

准备工作流程

单独安装 yt-dlp。备选流程会在下载音频或模型前询问;引用时保留字幕时间。

yt-dlp --list-subs "YOUTUBE_URL"

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:把文件夹复制到技能文件夹

把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。

git clone --depth 1 https://github.com/michalparkola/tapestry-skills.git
mkdir -p ~/.claude/skills
cp -R tapestry-skills/youtube-transcript ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /youtube-transcript,或直接描述任务。

在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。

Codex、Gemini CLI、Cursor 和 GitHub Copilot

这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:

git clone --depth 1 https://github.com/michalparkola/tapestry-skills.git
mkdir -p .agents/skills
cp -R tapestry-skills/youtube-transcript .agents/skills/
智能体项目文件夹用户文件夹说明
OpenAI Codex
.agents/skills/
~/.agents/skills/
输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

检查可用轨道

先列出字幕,避免猜测语言代码,并区分人工字幕与自动转录。

为备选流程预留资源

语音转录需要音频、磁盘及模型,是额外的下载和计算步骤。

关于 youtube-transcript 的常见问题

会先下载视频吗?

获取字幕时可以跳过视频下载。

没有字幕怎么办?

可以建议使用本地 Whisper 转录。

自动转录总是准确吗?

不是,请检查人名、数字和引文。

私密视频会失败吗?

会,访问、地区和身份验证限制仍然存在。

更多 AI 技能

相关技能

技能分类