youtube-summary
by sunghyo
Coding Agents & IDEsBrief
Summarize YouTube videos into structured Markdown with youtube2md, including chaptered notes, timestamp links.
Description
What This Skill Does
Converts YouTube videos into structured Markdown using the youtube2md CLI. Outputs chaptered notes, timestamp links, and key takeaways in full mode, or raw transcript JSON and plain text in extract mode. Works without an OpenAI key by falling back to local transcript extraction.
Extract mode pulls structured transcripts locally without sending content to any external API, making it viable in sensitive or air-gapped environments where full summarization is not acceptable.
When to Use It
- Taking study notes from a university lecture video
- Extracting a transcript without sending content to an external API
- Summarizing a conference talk in a specific language
- Batch processing multiple YouTube URLs into separate Markdown files
- Getting key takeaways from a long podcast-style video
Example Workflow
User asks: Summarize this YouTube video: https://youtube.com/watch?v=abc123
- 1
Validate the URL as a youtube.com or youtu.be link
- 2
Check whether OPENAI_API_KEY is set to select full or extract mode
- 3
Run scripts/run_youtube2md.sh with the URL in full mode
- 4
Verify the output Markdown file exists and is non-empty
- 5
Return the summary with chapter headings, timestamp links, and key takeaways
Structured Markdown with chaptered notes, clickable timestamp links, and a key takeaways section
Requirements
- OPENAI_API_KEY environment variable (optional, required only for full summarization mode)
- youtube2md CLI installed globally (npm i -g youtube2md@1.0.1)
Installation
clawhub install sunghyo/youtube-summaryRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.