Index of every page on this site: llms.txt
All skills
jimliu avatar

/baoyu-youtube-transcript

@bf1ff07 official
by Jim Liu 宝玉jimliu/baoyu-skills28k stars
3,011
Run it yourself

Downloads YouTube video transcripts/subtitles and cover images by URL or video ID. Supports multiple languages, translation, chapters, and speaker identification. Caches raw data for fast re-formatting. Use when user asks to "get YouTube transcript", "download subtitles", "get captions", "YouTube字幕", "YouTube封面", "视频封面", "video thumbnail", "video cover image", or provides a YouTube URL and wants the transcript/subtitle text or cover image extracted.

Use this Skill: https://skilld.dev/gh/jimliu/baoyu-skills/baoyu-youtube-transcript

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈124 tokens for metadata: the name and description. ≈1.5k when used: this file. ≈1.2k more on demand in 1 file.

Description uses 6.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈480 characters, or 6.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

YouTube Transcript

Works with manual and auto-generated transcripts. No API key or browser: uses YouTube's InnerTube API, falling back to yt-dlp when YouTube blocks the direct path. First run also fetches metadata and cover image and caches raw data for fast re-formatting.

Script Directory

{baseDir} = this SKILL.md's directory. ${BUN_X} = bun if installed; else npx -y bun if npx available; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

Script Purpose
scripts/main.ts Transcript download CLI

Usage

${BUN_X} {baseDir}/scripts/main.ts <youtube-url-or-id>          # markdown with timestamps (English)
${BUN_X} {baseDir}/scripts/main.ts <url> --languages zh,en,ja   # language priority
${BUN_X} {baseDir}/scripts/main.ts <url> --chapters --speakers
${BUN_X} {baseDir}/scripts/main.ts <url> --format srt
${BUN_X} {baseDir}/scripts/main.ts <url> --translate zh-Hans
${BUN_X} {baseDir}/scripts/main.ts <url> --list
Option Description Default
<url-or-id> YouTube URL or video ID (multiple allowed) Required
--languages <codes> Language codes, comma-separated, in priority order en
--format <fmt> text (.md: frontmatter incl. description, title, summary, optional TOC/cover/timestamps/chapters/speakers) or srt text
--translate <code> Translate to language code
--list List available transcripts (stdout only, no file)
--timestamps [HH:MM:SS → HH:MM:SS] timestamps per paragraph on
--no-timestamps Disable timestamps
--chapters Chapter segmentation from video description
--speakers Raw transcript with metadata for speaker identification
--exclude-generated Skip auto-generated transcripts
--exclude-manually-created Skip manually created transcripts
--refresh Force re-fetch, ignore cache
-o, --output <path> Output file path auto-generated
--output-dir <dir> Base output directory youtube-transcript

Input: https://www.youtube.com/watch?v=ID, https://youtu.be/ID, https://www.youtube.com/embed/ID, https://www.youtube.com/shorts/ID, or bare video ID.

Optional env: YOUTUBE_TRANSCRIPT_COOKIES_FROM_BROWSER — passed to yt-dlp --cookies-from-browser during fallback (e.g. chrome, safari, firefox, chrome:Profile 1).

Output Directory

youtube-transcript/
├── .index.json                          # Video ID → directory path (cache lookup)
└── {channel-slug}/{title-full-slug}/    # channel name / full title, kebab-case
    ├── meta.json                        # title, channel, description, duration, chapters, cover path, language info
    ├── transcript-raw.json              # raw API snippets `{ text, start, duration }[]`
    ├── transcript-sentences.json        # `{ text, start: "HH:mm:ss", end: "HH:mm:ss" }[]`
    ├── imgs/
    │   └── cover.jpg                    # Video thumbnail
    ├── transcript.md                    # from transcript-sentences.json
    └── transcript.srt                   # from transcript-raw.json (--format srt)

transcript-sentences.json splits on sentence-ending punctuation (.?!…。?! etc.), merges across snippets (CJK-aware), and allocates timestamps proportionally by character length.

Caching & Fallback

  • Repeat runs for the same video use the cache (no network). --refresh forces re-fetch; requesting a different language refreshes automatically.
  • Any run caches meta.json and imgs/cover.jpg, so cover/metadata-only requests just need one run.
  • On anti-bot / blocked responses the script retries alternate client identities, then yt-dlp. If yt-dlp is needed but missing, the agent decides how to make it available and continues — don't push the install decision to the user.

Workflow

  1. No language specified → run --list first to show options
  2. Always single-quote the URL (zsh globs ? → "no matches found"): 'https://www.youtube.com/watch?v=ID'
  3. Default: --chapters --speakers for the richest output
  4. The script saves cache + output and prints the file path
  5. --speakers → post-process per Speaker Identification below

Chapters (--chapters)

Parses chapter timestamps from the description (e.g., 0:00 Introduction), segments by chapter, groups snippets into paragraphs, saves .md with a Table of Contents. No further processing. No chapter timestamps → grouped paragraphs without chapter headings.

Speaker Identification (--speakers)

Implies --chapters. The script saves a raw .md with YAML frontmatter (title, channel, date, cover, description, language), the video description, the description's chapter list (if any), and the transcript in SRT format.

Spawn a sub-agent (a cheaper model like Sonnet is fine) to:

  1. Read the saved .md and {baseDir}/prompts/speaker-transcript.md
  2. Process the transcript per the prompt: identify speakers from metadata (title → guest, channel → host, description → names) and conversation cues; segment into chapters (description chapters, else topic shifts); format with **Speaker Name:** labels, 2-4 sentence paragraphs, [HH:MM:SS → HH:MM:SS] timestamps
  3. Overwrite the .md with the result, keeping the YAML frontmatter

Error Cases

Error Meaning
Transcripts disabled Video has no captions at all
No transcript found Requested language not available
Video unavailable Deleted, private, or region-locked
IP blocked Too many requests, try again later
Age restricted Login required for age verification
bot detected Script retries alternate clients, then yt-dlp; resolve missing fallback tooling yourself; if it still fails try YOUTUBE_TRANSCRIPT_COOKIES_FROM_BROWSER=safari (or your browser)

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning19d4 checks · Risk SAFE
  • Gen Agent Trust Hub19d

    The skill is functional for its stated purpose but contains a potential vulnerability to indirect prompt injection because it processes untrusted YouTube transcripts through an AI model without adequate boundary markers. It also executes external commands and may download remote components for the yt-dlp tool.

  • Socket19d

    No alerts

  • Snyk19d

    Risk: MEDIUM · 1 issue

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at bf1ff07. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago
version
1.1.0
Other metadata
metadata
{
  "openclaw": {
    "homepage": "https://github.com/JimLiu/baoyu-skills#baoyu-youtube-transcript",
    "requires": {
      "anyBins": [
        "bun",
        "npx"
      ]
    }
  }
}
  • TypeScript
  • youtube
  • transcripts
  • subtitles
  • captions
  • video-metadata
  • yt-dlp
  • multilingual

README badge

README badge for jimliu/baoyu-skills/baoyu-youtube-transcript

Downloads YouTube video transcripts, subtitles, and cover images by URL or video ID, with support for multiple languages, translation, chapter segmentation, and speaker identification. Caches raw data for fast re-formatting and falls back to yt-dlp when YouTube blocks direct API access.

Generated from the current SKILL.md.

Does this skill require a YouTube API key?
No. The skill uses YouTube's InnerTube API directly and falls back to yt-dlp when YouTube blocks the direct API path, so no API key is needed.
What languages and formats does this support?
Supports multiple languages (specified by language code, defaulting to English), translation to other languages, and output in markdown with timestamps or SRT subtitle format.
Does this cache transcripts?
Yes. On first fetch, the skill caches raw transcript data, sentence-segmented transcript, video metadata, and cover image. Subsequent runs for the same video reuse cached data unless --refresh is used.
Can this identify speakers in a transcript?
The --speakers option outputs raw transcript data with metadata for AI post-processing. Speaker identification requires a follow-up step: the skill includes a prompt template to guide an AI agent in labeling speakers based on video title, channel, and description.
What happens if YouTube blocks the request?
The skill retries with alternate client identities and then falls back to yt-dlp if available. If yt-dlp is unavailable and all retries fail, the agent must resolve the tooling itself.

Generated from the current SKILL.md. These answers refresh after source changes.