lecture-notes
/lecture-notes
Turn a video lecture (YouTube or any yt-dlp URL, or a local video file) into one faithful Obsidian Lecture note where every idea cites a timestamp or Key frame, checked by `lecture-notes verify`; or into its full text with the slides, code and formulas in place. Use when the user wants notes, a summary, a transcript or the full text of a lecture, talk, class or course video.
- Author
- Silvelle ↗
- Repository
- lecture-notes-skill ↗
- Licence
- MIT
- Last repository change
- 29.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Turn a video lecture (YouTube or any yt-dlp URL, or a local video file) into one faithful Obsidian Lecture note where every idea cites a timestamp or Key frame, checked by `lecture-notes verify`; or into its full text with the slides, code and formulas in place. Use when the user wants notes, a summary, a transcript or the full text of a lecture, talk, class or course video.
Original author description
Turn a video lecture (YouTube or any yt-dlp URL, or a local video file) into one faithful Obsidian Lecture note where every idea cites a timestamp or Key frame, checked by `lecture-notes verify`; or into its full text with the slides, code and formulas in place. Use when the user wants notes, a summary, a transcript or the full text of a lecture, talk, class or course video.
How it works
- 1. Read the request
- 2. Check the tool
- 3. Find the vault
- 4. Show the plan
- 5. Extract the Lecture bundle
- 6. Read the whole bundle
- 7. Write the note
- 8. Verify until it passes
- 9. Report
- Usage card
SKILL.md preview
---
name: lecture-notes
description: Turn a video lecture (YouTube or any yt-dlp URL, or a local video file) into one faithful Obsidian Lecture note where every idea cites a timestamp or Key frame, checked by `lecture-notes verify`; or into its full text with the slides, code and formulas in place. Use when the user wants notes, a summary, a transcript or the full text of a lecture, talk, class or course video.
license: MIT
compatibility: Needs the `lecture-notes` CLI (pipx install "lecture-notes[whisper] @ git+https://github.com/Silvelle/lecture-notes-skill"), ffmpeg, and a JS runtime such as deno for YouTube. The agent must be able to view images.
---
# Lecture notes
You turn one Lecture into one Lecture note, or into its full text. The `lecture-notes` CLI does the extraction; you do the writing; `verify` checks your writing against the Lecture bundle. The note is **faithful**: it holds only what the Lecture says or shows, and every idea carries a Citation.
## 1. Read the request
The user writes in plain words; there is no fixed syntax. Pick out:
- **Source**: a URL or a video file path. Required.
- **Vault**: the folder notes go to ("into ~/Obsidian/Lectures", "vault X").
- **Mode**: **note** (default: the ideas, grouped by topic) or **full** ("full text", "transcript", "everything", "word for word": everything said, in order, with what was shown in place).
- **Language** of the note ("in English"). Default: the Lecture's language.
If the request is empty or asks for help, show the user the Usage card at the end of this file, as written, and stop. If only the Source is missing, ask for it.
## 2. Check the tool
Run `lecture-notes doctor`. If the command is missing, install it with `pipx install "lecture-notes[whisper] @ git+https://github.com/Silvelle/lecture-notes-skill"` (or `pip install` with the same argument). If `doctor` reports ffmpeg missing, or the JS runtime missing for a YouTube Source, tell the user what to install and stop.
## 3. Find the vault
If the user named a vault, use it. Otherwise run `lecture-notes config vault`: it prints the remembered vault, or exits 1 when none is set. With none set, ask the user where their notes should go, save the answer with `lecture-notes config vault "<folder>"`, and tell them it will be reused.
The bundle goes to `<vault>/.lecture-bundles/<short-name>`, where `<short-name>` is the title in lowercase words joined by `-`.
## 4. Show the plan
```bash
lecture-notes extract "<source>" -o "<vault>/.lecture-bundles/<short-name>" --plan
```
It prints JSON and downloads nothing. Show the user this summary, filled from it:
```text
Lecture: <title> (<duration as h:mm:ss>)
Note: <vault>/<title>.md (<mode>, <language>)
Text: <transcript_origin in words>, <model> on <device>, about <estimate> min
```
Then go straight on, unless:
- `needs_confirmation` is true: a long job on the CPU. Ask whether to go ahead; on yes, add `--yes` in step 5.
- `transcript_origin` is null: no Transcript is possible here. Tell the user why (the `doctor` output says what is missing) and stop.
- The command fails as **blocked by the site**: relay the listed ways out and stop. Pass `--cookies-from-browser` only when the user names a browser.
## 5. Extract the Lecture bundle
```bash
lecture-notes extract "<source>" -o "<vault>/.lecture-bundles/<short-name>"
```
Done when it prints the bundle folder.
## 6. Read the whole bundle
- `manifest.json`: title, Source URL, channel, duration, language, `transcript_origin`, and the Key frame list.
- `transcript.md`: the full Transcript with timestamps, each Key frame where it appeared. Read all of it.
- Every image in `frames/`: open each one. Key frames carry the Board content (code, slides, formulas, diagrams) that speech alone garbles.
Done when you have read the Transcript end to end and looked at every Key frame.
## 7. Write the note
For **note** mode, read [note-format.md](note-format.md) now and follow it: frontmatter, topics, Citation forms, Board content, Unclear markers, language.
For **full** mode, read [full-text-format.md](full-text-format.md) now and follow it. Work through `transcript.md` from top to bottom.
Write the note to `<vault>/<title>.md`, with `/ \ : * ? " < > |` in the title replaced by `-`. Copy each Key frame you embed from `<bundle>/frames/` into `<vault>/attachments/<short-name>/`, so frames of different Lectures never collide, and embed them by that path.
## 8. Verify until it passes
```bash
lecture-notes verify "<vault>/<title>.md" "<bundle>" --json # note mode
lecture-notes verify "<vault>/<title>.md" "<bundle>" --json --full # full mode
```
Fix every reported problem at its line, using the `suggestion`, and run `verify` again. `uncovered_speech` (line 0) names a stretch of the Lecture the full text leaves out: add it. Done only when `verify` exits 0. Exit code 2 means the note or bundle path is wrong.
## 9. Report
Tell the user where the note is, that `verify` passed, where the Transcript came from, and every place you marked `[unclear]`.
## Usage card
```text
Lecture notes: faithful Obsidian notes from a video lecture.
/lecture-notes <link or video file>
/lecture-notes <link> full text
/lecture-notes <file> into ~/Obsidian/Lectures, in English
/lecture-notes help
Notes go to your vault: asked once, then remembered.
Change it: lecture-notes config vault <folder>
Every idea links to its moment in the video,
and a checker makes sure of it.
"full text" gives everything that was said,
with slides and code in place.
YouTube wants a login? Say which browser to use
("use firefox"), or download the video and give the file.
```
Files in this package (3)
- SKILL.md 6 KB
- full-text-format.md 3 KB
- note-format.md 3 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · Silvelle/lecture-notes-skill | 100 | MIT |
| Noam-Marom/academic-students | 100 | MIT |
Database snapshot: 13.11.2026 · package version 55f083f348a0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 92class-summary
Turns a lecture transcript or class slides into a clean lesson note. Use when I share a class recording transcript, lecture notes, or slides, or ask to summarize a class. - 95video-to-pdf
Turn one YouTube lecture URL or local lecture video, plus optional original materials, into complete evidence-backed study notes as PDF and/or editable PPTX while preserving the original timestamped transcript. Use when a user asks to convert a lecture/video into study material.… - 100lecture-tutor
Use when the user asks for a lecture recording to be explained, turned into study notes, a self-test, or an audio lesson (e.g. "讲一下 COURSE101 第 4 周", "把这节课的录像整理成讲解", "做个语音版"), or when an agent must locate a Panopto / Moodle recording and read its transcript. - 90lecture-to-notes
Turns a long lecture or talk recording into structured study notes, organized topic by topic like a deck's slides, each section summarizing what was actually explained, with real captured slides or a generated educational image (a diagram, a chart, a labeled illustration)… - 98lecture-video-to-notes
大学课堂录播/网课/讲座视频转完整学习资料:提取音频、逐字稿、分章讲义 DOCX、授课 PPTX、复习题与校验报告。用户提供课堂录像、讲座视频、网课回放,或说“转成讲义/做成课件/整理成笔记”时使用。 - 100video-to-article
Use this skill when the user wants to convert a lecture, presentation, or talk video into text formats (transcript, outline, or article). Trigger when user mentions processing video recordings, creating transcripts from lectures, or generating articles from recorded presentations.