
youtube-transcript
โ 277by intellectronica ยท part of intellectronica/agent-skills
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
This is the playbook your agent receives when the skill activates โ you don't need to read it to use the skill, but it's here to audit before installing.
YouTube Transcript
Extract transcripts from YouTube videos using the youtube-transcript-api.
Defaults
- Without timestamps (default): Plain text, one line per caption segment
- With timestamps:
[MM:SS] textformat (or[HH:MM:SS]for longer videos)
Supported URL Formats
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://youtube.com/embed/VIDEO_ID- Raw video ID (11 characters)
Output
- CRITICAL: YOU MUST NEVER MODIFY THE RETURNED TRANSCRIPT
- If the transcript is without timestamps, you SHOULD clean it up so that it is arranged by complete paragraphs and the lines don't cut in the middle of sentences.
- If you were asked to save the transcript to a specific file, save it to the requested file.
- If no output file was specified, use the YouTube video ID with a
-transcript.txtsuffix.
Notes
- Fetches auto-generated or manually added captions (whichever is available)
- Requires the video to have captions enabled
- Falls back to auto-generated captions if manual ones aren't available
npx skills add https://github.com/intellectronica/agent-skills --skill youtube-transcriptRun this in your project โ your agent picks the skill up automatically.
Usage
Run the script with a YouTube URL or video ID:
uv run scripts/get_transcript.py "VIDEO_URL_OR_ID"With timestamps:
uv run scripts/get_transcript.py "VIDEO_URL_OR_ID" --timestampsNo common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under CC0-1.0โ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ