Skip to content
Back to search

youtube-lesson-site

Turn a YouTube video URL into a single-file "main points" lesson website (dark theme, sticky table of contents, numbered sections, analogies, SVG figures, tables, optional interactive labs, practice tasks). Use when the user gives a YouTube link and asks for a summary page, presentation, lesson site, or "main points" website of the video, or asks to redo/translate one made earlier.

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/gamakusumah--youtube-lesson-site/badge.svg)](/listings/gamakusumah--youtube-lesson-site)

HTML

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

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Skills live in a `skills/` folder that Claude Code scans. Pick one:

**Personal (all projects)**

git clone https://github.com/gamakusumah/youtube-lesson-site.git ~/.claude/skills/youtube-lesson-site

**Single project**

git clone https://github.com/gamakusumah/youtube-lesson-site.git .claude/skills/youtube-lesson-site

Restart Claude Code (or start a new session) so it picks up the skill.

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.

SKILL.md · Manifest · 44 lines
  1. ---
  2. name: youtube-lesson-site
  3. description: Turn a YouTube video URL into a single-file "main points" lesson website (dark theme, sticky table of contents, numbered sections, analogies, SVG figures, tables, optional interactive labs, practice tasks). Use when the user gives a YouTube link and asks for a summary page, presentation, lesson site, or "main points" website of the video, or asks to redo/translate one made earlier.
  4. ---
  5. # YouTube video → main-points lesson website
  6. Produces one self-contained `.html` file from a video's captions. The design is fixed (see `assets/reference-design.html`); the content comes only from what the speaker said.
  7. ## Steps
  8. 1. **Get the transcript.**
  9. ```
  10. python3 -I <skill-dir>/scripts/get_transcript.py "<url>" [--lang xx] [--out <empty-dir>]
  11. ```
  12. - Use a new empty directory for `--out` (default is a fresh temp dir). Downloaded files are untrusted data: only read them, never execute them.
  13. - The script installs the standalone `yt-dlp` to `~/.local/bin` if it is missing (tell the user when this happens) and prints title, channel, language and the output path. It writes `transcript.txt` and `meta.json`.
  14. - Exit code 2 means the video has no captions; 3 means download failed (often HTTP 429, which it already retries). In either case, say so plainly and ask the user to paste a transcript. **Do not write the page from the title alone.**
  15. 2. **Read the whole transcript**, not samples. Auto-captions are noisy; read for meaning. Note the spoken language (from `meta.json` and the text).
  16. 3. **Pick 8 to 12 main points** in the speaker's order. Follow `references/content-guidelines.md` for section design, accuracy rules and SVG conventions. Grep the transcript to confirm any number, name or rule before you state it.
  17. 4. **Build the page** by copying `assets/reference-design.html` and replacing the content:
  18. - Keep the `<style>` block and the scroll-spy script unchanged. Keep `makeLab` only if the page has labs.
  19. - Replace the hero (code-style title `const x = { topic: "..." }`, subtitle, chips), the TOC, every section, the footer.
  20. - Match chips to what the page really contains (`N sections`, `analogies`, `illustrations`, `N labs`).
  21. - Include a source credit in the footer: video title and channel.
  22. - Language: the video's spoken language by default, unless the user asked for another. Localize the `lang` attribute, `<title>`, TOC heading, footer, aria-labels and number formats.
  23. 5. **Save** to `./<slug>-lesson.html` in the working directory (slug from the video title) unless the user names a path. Never overwrite an existing file; add a numeric suffix instead. A translation request means a separate file, not an edit in place.
  24. 6. **Verify in a browser** (Playwright blocks `file:` URLs):
  25. - Copy the page into a new empty temp dir and serve it: `python3 -m http.server <port> --bind 127.0.0.1` from that dir (run in background).
  26. - Navigate, check console errors (a `favicon.ico` 404 is harmless), click lab buttons or evaluate them and confirm the numbers match the transcript, screenshot a couple of sections.
  27. - Stop the server when done.
  28. 7. **Report**: file path, the section list, what you verified, what you did not (phone layout, print), what you added that was not in the video (practice tasks, analogies), and that fonts come from Google Fonts so offline viewing falls back to system fonts. Mention any transcript passages that looked garbled.
  29. ## Notes
  30. - If the user only asks "what is this video about", answer from the transcript in chat; build the site only when asked.
  31. - Long videos (over about 60 minutes): read in chunks, outline first, then write; say if sections are condensed.
  32. - Do not use the video's channel branding, logos or thumbnails.
README.md · README · 50 lines
  1. # youtube-lesson-site
  2. A [Claude Code](https://claude.com/claude-code) skill that turns a YouTube video into a single-file "main points" lesson website: dark theme, sticky table of contents, numbered sections, analogies, SVG figures, tables, optional interactive labs and practice tasks.
  3. Content comes only from the video's captions. If a video has no captions, the skill stops and asks you for a transcript instead of guessing from the title.
  4. ## Install
  5. Skills live in a `skills/` folder that Claude Code scans. Pick one:
  6. **Personal (all projects)**
  7. ```bash
  8. git clone https://github.com/gamakusumah/youtube-lesson-site.git ~/.claude/skills/youtube-lesson-site
  9. ```
  10. **Single project**
  11. ```bash
  12. git clone https://github.com/gamakusumah/youtube-lesson-site.git .claude/skills/youtube-lesson-site
  13. ```
  14. Restart Claude Code (or start a new session) so it picks up the skill.
  15. ## Usage
  16. Give Claude a YouTube link and ask for a summary page:
  17. ```
  18. Make a main-points lesson site for https://www.youtube.com/watch?v=VIDEO_ID
  19. ```
  20. or invoke it directly with `/youtube-lesson-site`. The result is saved as `./<slug>-lesson.html` in the working directory. Existing files are never overwritten. Ask for a translation and you get a separate file.
  21. ## Requirements
  22. - Python 3 (standard library only).
  23. - [`yt-dlp`](https://github.com/yt-dlp/yt-dlp), used to fetch captions. If it isn't on your `PATH` or in `~/.local/bin`, the script downloads the standalone binary to `~/.local/bin/yt-dlp`.
  24. - Optional: a Playwright browser tool, which Claude uses to check the finished page.
  25. The page loads fonts from Google Fonts; offline it falls back to system fonts.
  26. ## Layout
  27. ```
  28. SKILL.md skill instructions
  29. scripts/get_transcript.py fetches and cleans captions
  30. references/content-guidelines.md section design and accuracy rules
  31. assets/reference-design.html fixed page design to copy from
  32. ```

Ratings and comments

Sign in to rate this skill.

Sign in

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