Agent skill

Youtube Transcribe

by chubbyguan in chubbyguan/chubbyskills

YouTube 视频 → 下载 → 转录 → 翻译 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills.

MITAuto-check: notesMedia & Creative

Install Youtube Transcribe

skills CLI
$ npx skills add chubbyguan/chubbyskills --skill youtube-transcribe -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install chubbyguan/chubbyskills youtube-transcribe --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/chubbyguan/chubbyskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/youtube-transcribe .claude/skills/youtube-transcribe && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-transcribe
GitHub stars
1.2k
Token cost
~706 tokens
SKILL.md length
107 words
Files
4 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

YouTube 视频 → 下载 → 转录 → 翻译 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills.

  • Works in 4 steps: yt-dlp 下载音频 → SenseVoice-Small 转录 → 语言检测 + 翻译 → …
  • Tasks that involve Transcription
  • SKILL.md covers 为什么需要这个, 环境要求, 使用方法 and 流程, plus 5 more sections
  • Runs Python scripts from its folder; calls python, pip and yt-dlp; reaches youtube.com; needs DEEPSEEK_API_KEY

What it does

Youtube Transcribe is an agent skill from chubbyguan/chubbyskills. YouTube 视频 → 下载 → 转录 → 翻译 → 存为 Markdown。 支持中英文,英文内容自动翻译成中文,输出中英对照。

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/batch_transcribe.py` and `scripts/transcribe.py`).

It sits in Media & Creative, covering Transcription. It works with YouTube and DeepSeek. The repository describes itself as: 把中文全渠道内容(抖音 / B站 / 小红书 / 公众号 / X / 播客)采集进个人知识库的 14 个 AI Skill:图文存图、视频转文字稿、字幕优先免 GPU、RSS/YouTube 订阅调度与每日情报简报,附带知识库 MCP server。| Ingest Chinese content into your personal knowledge… The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription

Example prompts

  • “/youtube-transcribe”

Requirements

  • Python 3
  • A credential in DEEPSEEK_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. yt-dlp 下载音频
  2. SenseVoice-Small 转录
  3. 语言检测 + 翻译
  4. 生成 Markdown

What it can do on your machine

Read from SKILL.md and the folder at commit 1b759b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip
    • yt-dlp

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com

    Also links to:

    • github.com
    • platform.deepseek.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DEEPSEEK_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Transcribe loads about 706 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 107 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~706

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:37
    # Ubuntu: sudo apt install ffmpeg && pip install yt-dlp

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from chubbyguan/chubbyskills at commit 1b759b1, republished under its MIT licence (© chubbyguan). 107 words, ~706 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-transcribe/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
youtube-transcribe
description
YouTube 视频 → 下载 → 转录 → 翻译 → 存为 Markdown。 支持中英文,英文内容自动翻译成中文,输出中英对照。
metadata.category
media
metadata.triggers
["用户发送 YouTube 视频链接", "把这个 YouTube 视频转成文字", "帮我转录这个 YouTube", "YouTube 翻译"]
metadata.version
1.0.0
metadata.tags
["media", "audio", "video", "transcription", "youtube", "translation"]

YouTube 视频转录 + 翻译 Skill

字幕优先:先抓官方/自动字幕(秒级、免 GPU),抓不到再下载音频用 SenseVoice-Small 转录;英文内容自动翻译成中文,输出中英对照 Markdown。加 --no-subtitle 可强制走音频转录。

为什么需要这个

YouTube 有大量优质英文内容,但很多人没时间看完或语言不通。这个 skill:

  • 转录视频为文字(支持中英文)
  • 英文内容自动翻译成高质量中文
  • 输出中英对照,方便学习

环境要求

bash
# Python 3.9+
python -m venv .venv
source .venv/bin/activate

# 依赖
pip install funasr modelscope torch torchaudio

# 系统依赖
# macOS: brew install ffmpeg yt-dlp
# Ubuntu: sudo apt install ffmpeg && pip install yt-dlp

# 翻译功能(可选,英文视频需要)
export DEEPSEEK_API_KEY="your-api-key"

使用方法

bash
python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx"
python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --output ./output
python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --no-translate  # 不翻译
python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --no-subtitle  # 强制音频转录
python scripts/batch_transcribe.py urls.txt -o ./output --no-translate

流程

Step 1: yt-dlp 下载音频
bash
yt-dlp --extract-audio --audio-format mp3 --audio-quality 128K \
  "https://www.youtube.com/watch?v=xxxxx"
Step 2: SenseVoice-Small 转录
python
from funasr import AutoModel
model = AutoModel(model="iic/SenseVoiceSmall", ...)
result = model.generate(input=audio_path, language="auto", use_itn=True)
Step 3: 语言检测 + 翻译
  • 中文内容 → 直接输出
  • 英文内容 → LLM 翻译成中文,输出中英对照
Step 4: 生成 Markdown
markdown
---
title: 视频标题
type: note
tags: [YouTube]
language: en
translated: true
---

# 视频标题

> 转录引擎:SenseVoice-Small | 翻译:DeepSeek

## 中文翻译

翻译内容...

---

## English Original

原文内容...
批量模式

scripts/batch_transcribe.py 支持 URL 列表批处理,默认单条失败后继续处理下一条;需要严格模式时加 --stop-on-error。

翻译配置

默认使用 DeepSeek API 翻译。需要设置环境变量:

bash
export DEEPSEEK_API_KEY="your-api-key"

支持的 LLM:

  • DeepSeek(推荐,性价比高)
  • OpenAI
  • 任何兼容 OpenAI API 格式的服务

性能数据

视频时长下载转录翻译总耗时
5 min~10s~5s~10s~30s
10 min~15s~10s~20s~50s
30 min~30s~30s~60s~2min

已知限制

  • SenseVoice-Small 对英文转录准确率不如中文
  • 翻译质量取决于 LLM 能力
  • 长视频翻译可能需要较长时间
  • 部分 YouTube 视频有地区限制

参考项目

⚖️ 合规声明

仅供个人学习与研究使用。请遵守目标平台的服务条款(ToS)与 robots 规则,控制请求频率,不要用于批量抓取、商用爬取或侵犯他人权益的场景。下载内容的版权归原作者所有。

© chubbyguan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in youtube-transcribe of chubbyguan/chubbyskills.

  • SKILL.md
  • requirements.txt
  • scripts/batch_transcribe.py
  • scripts/transcribe.py

Open the folder on GitHubat commit 1b759b1

Compare with similar skills

Youtube Transcribe next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Transcribe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Transcribe this skillchubbyguan/chubbyskills1.2k—~706Automated safety check: NotesMIT
Watching Videosoxbshw/watch-skill470—~599Automated safety check: NotesMIT
VideoiBigQiang/feedgrab614—~1.6kAutomated safety check: PassMIT
Member Skill DistillerJamailar/Beav1.8k—~296Automated safety check: PassCustom licence
WatchTheCraigHewitt/skills159—~1.6kAutomated safety check: NotesMIT
Scenario Caption Studioscenario-labs/skills946—~3.4kAutomated safety check: PassMIT

Similar skills

  • Watching Videos

    oxbshw/watch-skill

    The user shared a video URL, a YouTube/TikTok/stream link, a local video file, a screen recording, a meeting recording, or a playlist/folder of videos — "watch this", "summarize this video", "what's…

    470 GitHub stars~599 tokensUpdated 26 days ago
    Media & CreativeAuto-check: notes
  • Video

    iBigQiang/feedgrab

    Video & Podcast Digest — send a video/podcast link, get full transcript + structured summary.

    614 GitHub stars~1.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Distill team members from profile, files, and YouTube subtitles into session-activated member skills.

    1.8k GitHub stars~296 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Watch

    TheCraigHewitt/skills

    When the user wants to read, transcribe, summarize, or research a video — YouTube link, podcast clip, Loom, TikTok, X/Twitter video, local file, or any URL yt-dlp supports.

    159 GitHub stars~1.6k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes
  • Scenario Caption Studio

    scenario-labs/skills

    A skill your agent uses when a video needs its spoken words on screen through Scenario via MCP: burned-in styled captions for a TikTok, Reels, or Shorts cut, ad captions for sound-off feeds, YouTube…

    946 GitHub stars~3.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Voice Memo Sync

    LeoYeAI/openclaw-master-skills

    Sync, transcribe, and intelligently organize voice memos, audio/video files, and URLs.

    2.2k GitHub stars~5.1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from chubbyguan/chubbyskills

All 14 skills in this repo
  • Bilibili Transcribe

    chubbyguan/chubbyskills

    哔哩哔哩视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~578 tokensUpdated 3 days ago
    Auto-check: notes
  • Douyin Transcribe

    chubbyguan/chubbyskills

    抖音视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~551 tokensUpdated 3 days ago
    Auto-check: notes
  • Industry Intelligence Radar

    chubbyguan/chubbyskills

    行业情报雷达:多源扫描(X/即刻/V2EX/HN) → 关键词过滤 → 趋势检测 → 每日情报简报。触发词:行业情报、竞品监控、热点扫描、情报雷达

    1.2k GitHub stars~806 tokensUpdated 3 days ago
    Auto-check passed
  • Knowledge Base Management

    chubbyguan/chubbyskills

    管理本地 Markdown/Obsidian 知识库:素材入库、健康检查、增量索引、关键词与 semantic-lite 检索、逐字原文资料包、归档和 MCP 连接。用于搜索知识库、整理资料及为 Agent 准备可定位的引用。

    1.2k GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • Learning Notes Automation

    chubbyguan/chubbyskills

    学习笔记自动化:视频/播客转录 → 知识点提取 → 闪卡生成 → 知识图谱更新。触发词:学习笔记、闪卡、Anki、知识提取、视频学习

    1.2k GitHub stars~898 tokensUpdated 3 days ago
    Auto-check passed
  • Podcast Transcribe

    chubbyguan/chubbyskills

    播客/小宇宙 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check: notes

Works with

Questions about Youtube Transcribe

What does Youtube Transcribe do?

YouTube 视频 → 下载 → 转录 → 翻译 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills. Youtube Transcribe is an agent skill from chubbyguan/chubbyskills.

When should I use Youtube Transcribe?

Youtube Transcribe fits situations like: tasks that involve Transcription.

How do I install Youtube Transcribe in Claude Code?

Run `npx skills add chubbyguan/chubbyskills --skill youtube-transcribe -a claude-code`. Or copy the skill folder (youtube-transcribe in chubbyguan/chubbyskills) into .claude/skills/youtube-transcribe in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Transcribe in Codex?

Run `npx skills add chubbyguan/chubbyskills --skill youtube-transcribe -a codex`. Or copy the skill folder (youtube-transcribe in chubbyguan/chubbyskills) into .agents/skills/youtube-transcribe in your project. Codex loads it when a task matches its description.

Can I use Youtube Transcribe in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chubbyguan/chubbyskills --skill youtube-transcribe -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-transcribe, .gemini/skills/youtube-transcribe, .github/skills/youtube-transcribe and .opencode/skills/youtube-transcribe in your project.

What does Youtube Transcribe need to run?

Going by SKILL.md and its folder, Youtube Transcribe needs Python for the scripts in its folder, the command-line tools its instructions call (python, pip and yt-dlp) and credentials named DEEPSEEK_API_KEY. Our summary lists: Python 3; A credential in DEEPSEEK_API_KEY.

Does Youtube Transcribe access the network?

SKILL.md names 3 domains. In commands or code: youtube.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com and platform.deepseek.com. This is read from the text; nothing was executed.

Is Youtube Transcribe safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Transcribe use?

Youtube Transcribe is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Transcribe use?

About 706 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Youtube Transcribe?

Skills that share tags, products or a category with Youtube Transcribe: Watching Videos (oxbshw/watch-skill, 470 stars), Video (iBigQiang/feedgrab, 614 stars), Member Skill Distiller (Jamailar/Beav, 1.8k stars) and Watch (TheCraigHewitt/skills, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Transcribe?

chubbyguan (a GitHub user) maintains it in chubbyguan/chubbyskills, which has 1,217 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: chubbyguan/chubbyskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.