youtube-summary
Skill6 starsChanged 3 months agoMITView on GitHub
Summarize a YouTube video into structured notes — TL;DR, key takeaways, chapter-by-chapter breakdown, and reference links. Use when the user shares a YouTube URL (or invokes `/youtube-summary <url>`) and wants a summary, takeaways, transcript notes, or a write-up of a talk, lecture, or tutorial. Fetches the transcript and chapters via yt-dlp (with cookie auth for gated videos), then prints the note or saves it to an Obsidian vault. For slide-heavy conference talks it can optionally extract the video's slides and embed them inline — diagrams, code, and charts the speaker shows but never says.
- Installs packages
4 other projects use a version of this.
Adopted by
Most recently taken up by
- phuocphn/galleytheir own version, first seen Oct 20, 2026
- parkbarg/claude-skillstheir own version, first seen Oct 3, 2026
- veryCoolTimo/youtube-summary-skilltheir own version, first seen Jul 2, 2026
- dandacompany/claude-skillstheir own version, first seen Oct 20, 2025
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- dandacompany/claude-skills★ 2same name
- phuocphn/galley★ 1same name
- parkbarg/claude-skills★ 0same name
- veryCoolTimo/youtube-summary-skill★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repositoryOne other file it gives its agents.
- plangateSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 4 are distinctive, and 8 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 40
Use the resolver's values as placeholders below ($NOTES_DIR, $VAULT_NAME, …).
- Very specific: line 42
Offer Obsidian mode: if the user uses Obsidian and you're in MODE=plain: help them create ~/.config/youtube-summary/config.sh (template: …
- Very specific: line 53
Run resolve-config.sh (above) and note MODE and NOTES_DIR (plus the vault vars in obsidian mode) for the steps below.
- Very specific: line 57
Run the helper script next to this SKILL.md:
- Very specific: line 73
Use the Read tool on ~/.cache/yt-summary/latest.txt (already allowlisted — no permission prompt).
- Distinctive: line 138
Only when the user asks to include slides for a specific video.
- Distinctive: line 159
If slides fill the frame edge-to-edge with no PiP/animation, you can omit the crops (defaults to full frame).
- Very specific: line 172
Read the sheets/sheet_*.jpg contact sheets (6 slides each, row-major) to transcribe content and map the deck.
- Distinctive: line 189
Put the slide image next to its transcription — e.g.
- Very specific: line 194
Delete the cached video1080.mp4 (and any slides_out/detect/probe scratch) when done — keep final/ and sheets/ only if useful.
- Distinctive: line 206
Read more links must be real: Only include URLs you're confident exist — official docs, JEPs, well-known project pages.
- Very specific: line 211
All paths come from resolve-config.sh (env vars or ~/.config/youtube-summary/config.sh).
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
youtube-summary
Turn a YouTube video into a structured note in the user's Obsidian vault.
When to use
- User pastes a YouTube URL and asks for a summary / takeaways / notes
- User invokes
/youtube-summary <url> - User says something like "write this up", "save this video", etc. with a YouTube link
By default, summaries are built from the transcript only. If the user says the video has important slides (or asks to "include the slides", "the slides matter", a slide-heavy conference talk, etc.), also run the opt-in slide flow in the section below. Do not extract slides unless the user asks for this video specifically — it downloads the full video (~hundreds of MB) and is slow.
Configuration (optional)
The output location is not hardcoded — resolve it at runtime:
~/.claude/skills/youtube-summary/resolve-config.shIt always succeeds and prints a MODE plus a NOTES_DIR (the absolute folder to
write the note into). Two modes:
MODE=obsidian— an Obsidian vault is configured; it also printsVAULT_NAME,VAULT_PATH,NOTES_SUBFOLDER. The note goes into the vault and is opened in Obsidian; slide images embed via![[wikilinks]].MODE=plain— no vault configured (works out-of-the-box); the note is printed in the reply to the user, not saved to a file. (If slides are being embedded, it's saved toNOTES_DIR= the current directory instead, since the images need to live on disk; slides embed via standard Markdown image links.)
Use the resolver's values as placeholders below ($NOTES_DIR, $VAULT_NAME, …).
Offer Obsidian mode if the user uses Obsidian and you're in MODE=plain:
help them create ~/.config/youtube-summary/config.sh (template:
config.example.sh next to this SKILL.md) with their vault name, absolute path,
and notes subfolder — or set env vars OBSIDIAN_VAULT_NAME /
OBSIDIAN_VAULT_PATH / NOTES_SUBFOLDER for a one-off run.
- Filename:
<video title>.md(sanitize: replace/with-, strip leading/trailing whitespace, no quotes)
Procedure
0. Resolve config
Run resolve-config.sh (above) and note MODE and NOTES_DIR (plus the vault
vars in obsidian mode) for the steps below.
1. Fetch transcript + metadata
Run the helper script next to this SKILL.md:
~/.claude/skills/youtube-summary/fetch-transcript.sh "<url>"It writes the output to ~/.cache/yt-summary/latest.txt (and also prints to stdout). Format:
- Line 1:
ID|TITLE|CHANNEL|UPLOAD_DATE|DURATION_SECONDS|URL ---CHAPTERS---- A chapters JSON array (
[{"start_time","end_time","title"}, ...]) orNAif the video has no chapters ---TRANSCRIPT---- Rest: cleaned transcript text
Cookies are cached at ~/.cache/yt-summary/cookies.txt so the macOS Keychain only prompts on first run or when cookies expire. If YouTube auth fails, the script auto-refreshes from $BROWSER (default chrome). Override with BROWSER=safari ~/.claude/skills/youtube-summary/fetch-transcript.sh "<url>" if Chrome isn't your primary browser.
2. Read the transcript
Use the Read tool on ~/.cache/yt-summary/latest.txt (already allowlisted — no permission prompt). The transcript is auto-captioned so expect typos — fix obvious ones in the summary using context (e.g. "Cloud Code" → "Claude Code", "JGC" → "ZGC", brand/product names, technical terms).
Chapters: if the ---CHAPTERS--- section is a JSON array (not NA), use the chapter titles (in order) as the section structure for the "Key takeaways" headings — they're the author's own outline. Map transcript content into each chapter's [start_time, end_time) window, and (for slide videos) align slides by their timestamp too. If chapters are NA, fall back to inferring 3-6 topical headings yourself.
3. Write the note
Build the note using the template below. Where it goes depends on MODE:
MODE=obsidian— write the file to$NOTES_DIR/<title>.md(create$NOTES_DIRif needed).MODE=plain— do not write a file; print the full note directly in your reply to the user (the whole Markdown document). Exception: if you're embedding slides, the images must live on disk — so in that case write the note + slides folder to$NOTES_DIRand tell the user the path instead of printing.
Template:
---
title: <video title>
speaker: <speaker name if identifiable from transcript, else omit>
channel: <channel>
url: <url>
published: <YYYY-MM-DD from upload_date>
duration: <Hh Mm Ss or Mm Ss>
watched: <today's date YYYY-MM-DD>
tags:
- youtube
- <topic tags inferred from content, 2-5 tags>
---
# <title>
## TL;DR
<2-3 sentences. The actual thesis of the talk, not generic platitudes.>
## Key takeaways
### <topical heading 1>
- <specific, concrete points — name the libraries, versions, numbers, trade-offs>
- <not vague — "they use ZGC" is bad; "Generational ZGC is now default; G1 had ~1.5s pauses causing IPC timeouts → retries" is good>
### <topical heading 2>
- ...
(Headings = the video's chapter titles when it has them; otherwise 3-6 topical headings you infer from the talk structure.)
## Read more / related
- **<resource name>** — <one-line why it matters>: <url>
- ... (5-12 items: official docs, JEPs, blog posts the speaker referenced, related Obsidian notes via [[wikilinks]])
## Open questions / things to dig into
- <thing the speaker glossed over that the user might want to explore>
- <POC ideas, things to try in our own stack>4. Open / report
MODE=obsidian— open it in Obsidian (URL-encode the path):
Or, if the Obsidian CLI is installed and enabled,open "obsidian://open?vault=$VAULT_NAME&file=$NOTES_SUBFOLDER/<title>.md"obsidian open path="$NOTES_SUBFOLDER/<title>.md".MODE=plain— nothing to open; you already printed the note in your reply. (Only if slides forced a file: tell the user the path you wrote to.)
Slide-aware summaries (opt-in)
Only when the user asks to include slides for a specific video. Slides capture diagrams, code, charts, and bullet text the speaker shows but never says — and they're a safety net when the auto-caption transcript is truncated.
Prereqs: ffmpeg + ffprobe (e.g. brew install ffmpeg). The helper reuses the
same cookie cache as fetch-transcript.sh.
S1. Probe the layout
~/.claude/skills/youtube-summary/fetch-slides.sh "<url>" --probeDownloads a 1080p copy (cached) and dumps ~6 sample frames to
~/.cache/yt-summary/slides/<id>/probe/. Read those frames with the Read
tool to determine the recording's layout, then choose two crop rectangles
(ffmpeg W:H:X:Y = width:height:x-offset:y-offset):
--detect-crop: a tight interior slide sub-region with no speaker picture-in-picture and no animated background. Used only for change detection; a moving speaker or animated border makes every frame look "changed".--save-crop: the full slide region to save as the image (exclude the speaker PiP and any fiery/animated chrome, but keep the whole slide).
If slides fill the frame edge-to-edge with no PiP/animation, you can omit the crops (defaults to full frame).
S2. Extract slides + contact sheets
~/.claude/skills/youtube-summary/fetch-slides.sh "<url>" \
--detect-crop W:H:X:Y --save-crop W:H:X:YWrites one image per unique slide to final/, 2x3 contact sheets to sheets/,
and manifest.txt (<index> <seconds> <filename>). Tune with --gap N
(collapse changes < N s apart; default 4), --fps N, --thresh hi:lo:frac.
S3. Read sheets, then curate
Read the sheets/sheet_*.jpg contact sheets (6 slides each, row-major) to
transcribe content and map the deck. Many slides are incremental builds of the
same slide — pick the settled/most-complete version of each. Aim to embed
the genuinely informative slides (diagrams, charts, unique code), not every
build. Read individual final/ images at full resolution when code/diagrams
need precise transcription.
S4. Copy chosen slides into the vault + embed
Copy the curated slides into a sibling folder of the note, renaming to unique, descriptive names (prefix with a short video slug so filenames stay unique):
$NOTES_DIR/<slug>-slides/<slug>-NN-description.jpgEmbed inline at the relevant point in the note, using the syntax for the mode:
MODE=obsidian:![[<slug>-NN-description.jpg]](Obsidian resolves by filename)MODE=plain:(standard Markdown relative link, so it renders in any viewer)
Put the slide image next to its transcription — e.g. the diagram image followed by a short prose description, or the code-slide image followed by the same code in a fenced block.
S5. Cleanup
Delete the cached video1080.mp4 (and any slides_out/detect/probe scratch)
when done — keep final/ and sheets/ only if useful. The video is the large
artifact.
Note in the front-matter or a callout that slides were merged in, and if the transcript was truncated say which sections came from slides only.
Style rules for the summary
- Be specific, not generic. Concrete library names, version numbers, latency numbers, JEP numbers. If the speaker says "we saw lower errors", quantify if they did; if not, say "significantly" not "much".
- Capture the interesting parts. What's the non-obvious insight, the counter-intuitive trade-off, the gotcha? Skip filler ("they have many users", "they use microservices") unless it's load-bearing.
- Fix auto-caption errors. Watch for: product names ("Cloud Code" → "Claude Code"), acronyms ("JGC" → "ZGC"), homophones ("there/their"), hallucinated punctuation.
- Read more links must be real. Only include URLs you're confident exist — official docs, JEPs, well-known project pages. If the speaker referenced a blog post you can't verify the URL for, write the search query instead:
search "Spring One Paul Bakker testing" on YouTube. - Use
[[wikilinks]]to seed connections to existing or future notes in the vault. - One-line YAML tags — lowercase, kebab-case, 2-5 topic tags beyond the always-present
youtube.
Notes
- All paths come from
resolve-config.sh(env vars or~/.config/youtube-summary/config.sh). Nothing vault-specific is hardcoded in this skill — keep it that way so it stays publishable. - On macOS the filesystem is case-insensitive, so match the casing of
NOTES_SUBFOLDERto the user's existing folder to avoid creating a near-duplicate. - Opening via the
obsidian://URI works without extra setup. Theobsidian openCLI alternative requires the Obsidian CLI enabled (Settings → General → CLI) with theobsidianbinary on$PATH.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

