baoyu-youtube-transcript

Downloads YouTube transcripts, subtitles, and cover images with caching and speaker identification.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill baoyu-youtube-transcript-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-youtube-transcript
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/assignment-generator/antigravity-skills-main/antigravity-skills-main/skills/baoyu-youtube-transcript
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill baoyu-youtube-transcript-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, and includes scripts (resource) components.

What problem does it solve? Getting usable text out of YouTube videos normally requires manual copying, paid APIs, or browser automation. This Skill downloads transcripts and subtitles directly from YouTube by URL or video ID, with no API key required, and caches the raw data so re-formatting is instant. ## Core Features & Use Cases - Transcript & Subtitle Download: Fetches manually created and auto-generated captions via YouTube's InnerTube API, with automatic fallback to yt-dlp when blocked. - Rich Formatting Options: Outputs Markdown with timestamps, chapter segmentation from video descriptions, SRT subtitle files, and multi-language translation. - Speaker Identification: Generates a raw transcript plus a prompt template so an AI sub-agent can label speakers and structure chapters. - Use Case: A researcher needs the Chinese subtitles of a conference talk as an SRT file, plus a chapter-segmented Markdown summary with speaker labels for their notes — one command produces both from cached data. ## Quick Start Ask the assistant to download the transcript with chapters and speaker identification for a given YouTube URL, optionally specifying a language such as zh or en.

Frequently Asked Questions about baoyu-youtube-transcript

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download a YouTube transcript without an API key?

Run the main.ts script with a YouTube URL or video ID using bun or npx. It calls YouTube's InnerTube API directly, so no API key or browser login is required, and it falls back to yt-dlp if the direct path is blocked.

How to get YouTube subtitles in a specific language?

Pass the --languages flag with comma-separated language codes in priority order, such as --languages zh,en,ja. Use --list first to see which manual and auto-generated transcripts a video actually offers.

Can I translate YouTube captions into another language?

Yes, use the --translate option with a target language code, for example --translate zh-Hans. The transcript must be marked as translatable by YouTube, and the requested language must appear in its translation list.

Why does YouTube transcript download fail with bot detected errors?

YouTube sometimes blocks direct API requests with anti-bot responses. The script retries with alternate client identities and then falls back to yt-dlp; if that fails, set YOUTUBE_TRANSCRIPT_COOKIES_FROM_BROWSER to your browser name.

Does the script re-download data when converting transcript formats?

No. On first fetch it caches meta.json, raw snippets, sentence-segmented text, and the cover image. Re-running for the same video reuses the cache unless you pass --refresh or request a different language.