SkillAgentSearch skills...

youtube-transcribe-skill

Extract subtitles/transcripts from YouTube videos. Triggers: "youtube transcript", "extract subtitles", "video captions", "视频字幕", "字幕提取", "YouTube转文字", "提取字幕".

Install / Use

npx skills add feiskyer/claude-code-settings --skill youtube-transcribe-skill

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Supported Platforms

Universal

Tags

Our assessment of youtube-transcribe-skill

youtube-transcribe-skill scores 83/100 on our quality scale, 266th of 319 Customer Support skills we index.

Its SKILL.md is 4.5 KB long, well organised into 17 sections with 3 code examples: a solid amount of guidance for an agent.

With 1,654 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
14/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-02 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

youtube-transcribe-skill compared with similar skills

All 4 of these similar skills score higher than youtube-transcribe-skill; compare them before choosing.

SkillScoreStarsUpdatedFormat
youtube-transcribe-skill (this skill)by feiskyer831.7k3mo agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install youtube-transcribe-skill?
Run npx skills add feiskyer/claude-code-settings --skill youtube-transcribe-skill. The install tabs above show the steps for each supported agent.
Which AI agents does youtube-transcribe-skill work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is youtube-transcribe-skill safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is youtube-transcribe-skill still maintained?
The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: youtube-transcribe-skill description: 'Extract subtitles/transcripts from YouTube videos. Triggers: "youtube transcript", "extract subtitles", "video captions", "视频字幕", "字幕提取", "YouTube转文字", "提取字幕".'

YouTube Transcript Extraction

Extract subtitles/transcripts from a YouTube video URL and save them as a local file.

Input YouTube URL: $ARGUMENTS

Step 1: Verify URL

Confirm the input is a valid YouTube URL (supports youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/ formats). If no URL is provided via arguments, check the conversation context for a YouTube link.

Step 2: CLI Quick Extraction (Priority Attempt)

Use command-line tools to quickly extract subtitles.

2.1 Check Tool Availability

Execute which yt-dlp.

  • If yt-dlp is found, proceed to 2.2.
  • If yt-dlp is not found, skip to Step 3.

2.2 Get Video Title

yt-dlp --cookies-from-browser=chrome --get-title "[VIDEO_URL]"
  • Tip: Always add --cookies-from-browser to avoid sign-in restrictions. Default to chrome.
  • If it fails with a browser error (e.g., "Could not open Chrome"), ask the user to specify their available browser (e.g., firefox, safari, edge) and retry.

2.3 Download Subtitles

yt-dlp --cookies-from-browser=chrome --write-auto-sub --write-sub --sub-lang zh-Hans,zh-Hant,en --skip-download --output "<Video Title>.%(ext)s" "[VIDEO_URL]"

2.4 Convert to Plain Text

yt-dlp saves subtitles as .vtt or .srt files. Convert the downloaded file to plain Timestamp Text format:

  1. Read the downloaded subtitle file (.vtt or .srt).
  2. Strip VTT/SRT headers, styling tags, and duplicate lines.
  3. Save as <Video Title>.txt with one Timestamp Text entry per line.

2.5 Verify Results

  • Exit code 0: Convert and save the subtitle file, then report completion.
  • Exit code non-0:
    • If error is related to browser/cookies, ask user for correct browser and retry.
    • If other errors (e.g., video unavailable), proceed to Step 3.

Step 3: Browser Automation (Fallback)

When the CLI method fails or yt-dlp is missing, use Chrome DevTools MCP to extract subtitles via browser UI automation.

3.1 Check Tool Availability

Check if Chrome DevTools MCP tools are available (look for tools matching chrome__new_page or similar).

If Chrome DevTools MCP is not available and yt-dlp was not found in Step 2, stop and notify the user: "Unable to proceed. Please either install yt-dlp (for fast CLI extraction) or configure Chrome DevTools MCP (for browser automation)."

3.2 Open Video Page

Use Chrome DevTools MCP new_page to open the video URL.

3.3 Analyze Page State

Use Chrome DevTools MCP take_snapshot to read the page accessibility tree.

3.4 Expand Video Description

The "Show transcript" button is usually hidden within the collapsed description area.

  1. Search the snapshot for a button labeled "...more", "...更多", or "Show more" (in the description block below the video title).
  2. Use Chrome DevTools MCP click to click that button.

3.5 Open Transcript Panel

  1. Use Chrome DevTools MCP take_snapshot to get the updated UI.
  2. Search for a button labeled "Show transcript", "显示转录稿", or "内容转文字".
  3. Use Chrome DevTools MCP click to click that button.
  4. If the button is not found, the video may not have a transcript available — notify the user and stop.

3.6 Extract Content via DOM

Directly reading the accessibility tree for long transcript lists is slow and token-heavy. Use Chrome DevTools MCP evaluate_script to run this JavaScript instead:

() => {
  const segments = document.querySelectorAll("ytd-transcript-segment-renderer");
  if (!segments.length) return "BUFFERING";
  return Array.from(segments)
    .map((seg) => {
      const time = seg.querySelector(".segment-timestamp")?.innerText.trim();
      const text = seg.querySelector(".segment-text")?.innerText.trim();
      return `${time} ${text}`;
    })
    .join("\n");
};

If it returns "BUFFERING", wait a few seconds and retry (up to 3 attempts).

3.7 Save and Cleanup

  1. Save the extracted text as <Video Title>.txt.
  2. Use Chrome DevTools MCP close_page to release resources.

Output Requirements

  • Save the subtitle file to the current working directory.
  • Filename format: <Video Title>.txt
  • File content format: Each line should be Timestamp Subtitle Text.
  • Report upon completion: file path, subtitle language, and total number of lines.

Related Skills

View on GitHub
GitHub Stars1.7k
CategoryCustomer
Updated3mo ago
Forks239

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions