Skip to content
Back to search

youtube-learner

MarketplaceWorks with Claude CodeGitHub

Learn a skill from any YouTube tutorial with Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joebenscoter86--youtube-learner/badge.svg)](/listings/joebenscoter86--youtube-learner)

HTML

<a href="/listings/joebenscoter86--youtube-learner"><img src="/api/listings/joebenscoter86--youtube-learner/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "youtube-learner",
  4. "description": "Learn a skill from any YouTube tutorial with Claude Code.",
  5. "owner": {
  6. "name": "Joe Benscoter",
  7. "url": "https://joebenscoter.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "youtube-learner",
  12. "description": "Learn a skill from any YouTube tutorial: Claude listens to every word, reads every frame where the screen changes, writes checked step-by-step recipes, and proves them by building the result. macOS.",
  13. "version": "0.1.0",
  14. "author": { "name": "Joe Benscoter" },
  15. "source": "./",
  16. "category": "productivity",
  17. "keywords": ["youtube", "tutorial", "learning", "recipes"],
  18. "homepage": "https://github.com/joebenscoter86/youtube-learner",
  19. "repository": "https://github.com/joebenscoter86/youtube-learner"
  20. }
  21. ]
  22. }
README.md · README · 81 lines
  1. # YouTube Learner
  2. Give Claude a YouTube tutorial and it learns it the way a careful student would: it listens to every word, watches every moment the screen changes, and writes down what the video teaches as step-by-step recipes you can follow. Then it checks its own work against the video, and tries to build the result from its notes alone to prove they are good enough.
  3. It works on any narrated tutorial: software (spreadsheets, 3D, design, editing, code), and hands-on skills too (cooking, music, crafts), where the "proof" is a short card for you to try yourself.
  4. Made by [Joe Benscoter](https://joebenscoter.com). Free and open source.
  5. ## What you get
  6. For each video, a folder in `YouTube Learner` (in your home folder) with a file called `LEARNED.md`:
  7. - the video and its creator credited at the top, with a link back to the video;
  8. - one recipe per technique the video teaches, in plain steps, with every step marked **said** (the narrator says it), **shown** (you can see it on screen, with the exact frame saved next to it) or **inferred** (Claude's reading, not the video's);
  9. - the sizes, amounts and settings the result needs, measured on the video's own finished result, even when the narrator never says them;
  10. - for the recipes Claude could build on your computer, a picture of its build next to the video's result, and a plain verdict on whether they match.
  11. ## How it works
  12. 1. **Listens.** It downloads the video and transcribes every word on your Mac with a free speech engine (whisper.cpp), and checks that transcript against YouTube's captions.
  13. 2. **Watches.** It measures every frame for change and keeps the ones where something happens on screen, then reads the text on each one with Apple's built-in text recognition (the same thing that lets you copy text out of a photo).
  14. 3. **Lines them up.** Each sentence is matched with what was on screen while it was said, and with the values that changed ("Roughness went from 0.5 to 0.2 at 4:12").
  15. 4. **Writes.** Claude splits the video into techniques and starts writer agents, a few techniques each, who turn the words and frames into recipes.
  16. 5. **Checks.** A second agent who did not write them checks every claim against the video, and sends failures back to be fixed, up to three rounds. A recipe that still fails is held back, with the reason, never quietly kept.
  17. 6. **Proves.** For the recipes the video spends longest on, a builder who has never seen the video makes the result from the recipe alone, and a reviewer sets it beside the video's own result. Where Claude cannot build it (a cooking method, an app it cannot control), you get a try-it card instead and can send a photo of your result for the same comparison.
  18. Steps 1 to 3 run on your Mac and cost nothing. Steps 4 to 6 use your Claude plan.
  19. ## Set it up
  20. You need a Mac and [Claude Code](https://claude.com/claude-code): the Code tab in the Claude desktop app, or Claude Code in a terminal. Open it and paste this as a message:
  21. ```
  22. Read https://raw.githubusercontent.com/joebenscoter86/youtube-learner/main/INSTALL.md and follow it step by step. Do every step for me and tell me only when I need to click something or type my password.
  23. ```
  24. Claude installs the plugin, checks your Mac, installs only what is missing, and tells you when it is ready.
  25. Setup takes about 10 to 20 minutes, mostly downloading, and about 3 GB of space. Everything it installs is free. If your Mac does not have Homebrew (a free installer for tools like these), a Terminal window opens and asks for your Mac password once.
  26. ## Use it
  27. Paste a tutorial link and say what you want, for example:
  28. > Learn this for me: https://www.youtube.com/watch?v=...
  29. Claude tells you what the video teaches, works through it, and opens `LEARNED.md` when it is done. You can leave it running.
  30. ## Honest limits
  31. - **Mac only, for now.** The screen reading uses Apple's text recognition, which only exists on macOS. A Windows version would need another text reader (Windows has one built in, and the free Tesseract works anywhere) plus the Windows versions of the downloader, video toolkit and speech engine, which all exist. It is not built yet.
  32. - **A few videos a night.** Download too many and YouTube asks to confirm you are not a robot. When that happens the learner stops, tells you, and picks up where it left off when you try again a few hours later. It never signs in, never uses your browser's cookies and never tries to get around the check.
  33. - **English videos.** The speech model and the captions it asks for are English. Other languages would need the multilingual model.
  34. - **Time.** On a recent Mac, a 13 minute tutorial took under a minute to download and transcribe and about two minutes to line up. The agents took most of the time: about 30 minutes to write six recipes and check them (every one needed a second or third round), then 20 to 30 minutes to prove two of them. Older Macs transcribe and read frames more slowly.
  35. - **Disk.** About 1 GB for a 13 minute video while it is studied (longer videos, more). When you are done, Claude can delete the downloaded video and full-size frames and keep the recipes, proofs and small frames, which leaves about 300 MB.
  36. - **Your Claude plan.** The reading uses agents, and reading frames is the expensive part: the 13 minute test above took about fifteen agent runs. That is a big job for a Pro plan and comfortable on a Max plan. If you hit your limit, start again later and the learner resumes where it stopped.
  37. - **The recipes are only as good as the video.** When a tutorial skips a value, the recipe says so under `unknowns` rather than guessing. A recipe marked `unproven` has not been built yet; `proven` means you tried it and said it worked.
  38. ## Respect the creators
  39. Tutorials take real work. The learner is for your own study of videos you could watch anyway:
  40. - the video, its frames, audio and transcript stay on your Mac and are never uploaded or shared;
  41. - recipes are written in Claude's own words, not the creator's, and leave out their files, artwork and names;
  42. - every `LEARNED.md` credits the creator and links the video at the top. If a video helped you, go watch it, like it and subscribe.
  43. YouTube's terms limit downloading videos. Use this for personal study, a few videos at a time, and only for videos you have the right to watch.
  44. ## After Effects add-on
  45. For After Effects tutorials, if you also have the [Comp Room](https://github.com/joebenscoter86/after-effects-studio) plugin, the proof is built in After Effects itself. See `addons/after-effects/`.
  46. ## For the curious
  47. - `scripts/learn.mjs`: the download, transcription, frame and text steps (no model, no usage). `scripts/doctor.mjs`: checks what is installed. `scripts/assemble.mjs`: builds `LEARNED.md`.
  48. - `prompts/`: what each agent is told: listing techniques, writing, checking, proving, reviewing.
  49. - `skills/`: the two skills Claude runs, `setup` and `learn`.
  50. - `LESSONS.md`: every way the learner has been wrong so far, and the rule that now catches it.
  51. - Tests: `npm test` (no internet, no video).
  52. MIT licence.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.