Agent skill
yt-transcribe
Use when user asks about YouTube video content, wants to know what a video says, needs information from a YouTube URL, or when video transcription would answer their question
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/yt-transcribe
SKILL.md
YouTube Video Transcription
Overview
Use yt-transcribe to get the actual spoken content from YouTube videos. Web search and fetch tools cannot access video content - they only see metadata.
When to Use
Use this skill when:
- User shares a YouTube URL and asks what it says/contains
- User wants information that likely exists in a video
- User asks "what does this video talk about?"
- You need to extract spoken content from YouTube
Do NOT use:
- For video metadata only (title, description) - web search is faster
- When user explicitly wants just the link, not content
Quick Reference
| Flag | Purpose |
|---|---|
-q |
Required for LLMs - clean stdout, no progress noise |
-m tiny |
Faster transcription (less accurate) |
-m medium |
More accurate (slower, larger model) |
-o file |
Save to file instead of stdout |
-f srt/vtt |
Include timestamps |
Core Pattern
# Standard usage for LLM consumption
yt-transcribe "https://youtube.com/watch?v=VIDEO_ID" -q
# Faster but less accurate
yt-transcribe "https://youtube.com/watch?v=VIDEO_ID" -q -m tiny
# With timestamps
yt-transcribe "https://youtube.com/watch?v=VIDEO_ID" -q -f srt
Always use -q flag - suppresses progress output, gives clean transcript to stdout.
Workflow
- User provides YouTube URL or asks about video content
- Run:
yt-transcribe "URL" -q - Read and summarize the transcript for the user
- Answer their specific question using the transcript content
Common Mistakes
| Mistake | Fix |
|---|---|
| Trying WebFetch on YouTube URLs | YouTube blocks bots, use yt-transcribe |
Forgetting -q flag |
Progress output pollutes response, always use -q |
| Web searching for "what does video say" | Search finds metadata, not content - transcribe instead |
| Using without setup | Run yt-transcribe --setup first if binaries missing (exit code 5) |
Exit Codes
0- Success5- Binary not found (run--setup)3- Network error4- Transcription error
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?