wamikmk/lecture-skills

lecture-skills is a pair of Claude Code skills that turn a lecture, either a YouTube video or a raw transcript, into a clean, typeset HTML study document. The output includes properly rendered math notation and reading prompts meant to help someone actually study the material, rather than just having a wall of raw text. There are two skills bundled together. The first, lecture-yt, is a one shot pipeline: you give it a YouTube link, it fetches the video's transcript automatically, and hands the result off to the second skill. The second, lecture-reader, works on a transcript file you already have in VTT, SRT, or plain text format, and produces the final typeset HTML document. Each skill has its own slash command, /lecture-yt and /lecture-reader, and lecture-yt calls lecture-reader internally as part of its pipeline. To install, you copy both skill folders into your local Claude Code skills directory. Fetching YouTube captions requires the youtube-transcript-api Python package, which needs to be installed separately with pip. Once installed, running /lecture-yt with a YouTube URL, or /lecture-reader with an existing transcript, produces a finished study document. By default these documents are saved to a lecture-notes folder in your home directory, created automatically the first time you run it, though you can tell Claude to save elsewhere. Under the hood, lecture-yt runs a bundled Python script to pull the transcript from YouTube's caption track, then the reader pipeline cleans the text, reconstructs and classifies its structure, and typesets it into an HTML template file included in the project. This is a lightweight utility rather than a full application: there is no server, database, or web interface beyond the generated HTML files themselves. It is released under the MIT license.