third774/youtube-captions
opencode/skills/youtube-captions/SKILL.md
Extract captions and transcripts from YouTube videos for agent context. Tries manual subtitles, then auto-generated, then falls back to audio transcription via Whisper. Use when a user provides a YouTube URL and wants to understand, summarize, reference, or search video content.
$ install --global
skillsauthnpx skillsauth add third774/dotfiles youtube-captionsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 1:46 AM13.6s2 files scanned
SKILL.md
- name:
- youtube-captions
- description:
- Extract captions and transcripts from YouTube videos for agent context. Tries manual subtitles, then auto-generated, then falls back to audio transcription via Whisper. Use when a user provides a YouTube URL and wants to understand, summarize, reference, or search video content.
youtube-captions
Extract timestamped captions from YouTube videos. Output is VTT format (timestamps preserved).
Prerequisites
yt-dlp— REQUIRED (brew install yt-dlp)openai-whisper— REQUIRED only if video has no subtitles (pip install openai-whisper)- First run downloads the
smallmodel (~500MB) - Transcription is significantly slower than subtitle download
- First run downloads the
Usage
bash scripts/get-captions.sh <youtube-url> [language]
youtube-url— any valid YouTube video URLlanguage— subtitle language code (default:en)
Output goes to stdout. Status messages go to stderr.
Fallback Chain
- Manual subtitles — human-uploaded captions (fastest, most accurate)
- Auto-generated subtitles — YouTube's speech recognition
- Whisper transcription — downloads audio, transcribes locally with
whisper --model small
The script tries each step in order and exits on the first success.
Example
# Get English captions
bash scripts/get-captions.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
# Get Spanish captions
bash scripts/get-captions.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ" es
Output Format
VTT (Web Video Text Tracks) with timestamps:
WEBVTT
00:00:01.000 --> 00:00:04.000
First line of dialogue
00:00:04.000 --> 00:00:08.000
Second line of dialogue
Notes
- All temporary files (audio, intermediate subtitle files) are cleaned up automatically
- If neither yt-dlp subtitles nor Whisper are available, the script exits with an error and clear instructions
- Long videos with no subtitles will take time to transcribe — Whisper processes roughly at 1x realtime on CPU
Related Skills
third774/xcodebuildmcp
tools
VerifiedTrustedCommunity
Official skill for XcodeBuildMCP. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
5SKILL.mdUpdated Apr 17, 2026
third774/writing-tests
development
VerifiedTrustedCommunity
Write behavior-focused tests following Testing Trophy model with real dependencies, avoiding common anti-patterns like testing mocks and polluting production code. Use when writing new tests, reviewing test quality, or improving test coverage.
5SKILL.mdUpdated Apr 17, 2026
third774/visualizing-with-mermaid
data-ai
VerifiedTrustedCommunity
Create professional Mermaid diagrams with proper styling and visual hierarchy. Use when creating flowcharts, sequence diagrams, state machines, class diagrams, or architecture visualizations.
5SKILL.mdUpdated Apr 17, 2026
third774/verification-before-completion
testing
VerifiedTrustedCommunity
Run verification commands before claiming work is complete or fixed. Use before asserting any task is done, bug is fixed, tests pass, or feature works.
5SKILL.mdUpdated Apr 17, 2026