Skip to content
Skills Library
Education · Conversion & formats

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.

Licence
MIT
Last repository change
29.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.

Licence

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. 1. Read the request
  2. 2. Check the tool
  3. 3. Find the vault
  4. 4. Show the plan
  5. 5. Extract the Lecture bundle
  6. 6. Read the whole bundle
  7. 7. Write the note
  8. 8. Verify until it passes
  9. 9. Report
  10. Usage card
Original SKILL.md headings · 105 lines, 777 words
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

RepositoryScoreLicence
This page · Silvelle/lecture-notes-skill100MIT
Noam-Marom/academic-students100MIT

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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.