lecture-notes
Agent skill · Claude Code & Codex

Messy transcript in,
study-ready notes out.

Auto-generated lecture transcripts are long, repetitive, and half-garbled. This skill reads the whole thing, reconstructs what was actually said, and hands back a clean Word document — notes in the order the lecture unfolded, the key topics, and a checklist of everything you were assigned.

What it does

Notes you'd actually open before an exam.

Not a cleaned-up transcript — a rewrite. It follows how the lecture actually moved and grounds every detail in the material.

01

Fixes the garble

Misheard names, dropped words, homophones, and negations that flip a sentence's meaning — reconstructed from context and the subject, not transcribed as-is.

02

Cross-checks your material

Hand it slides, a handout, a syllabus, a PDF, even a photo of a whiteboard, and it uses them as the source of truth for spellings, terms, and citations.

03

Keeps the lecture's order

Chronological, so the notes stay anchored to the recording and two similar-sounding topics discussed at different points never get merged.

04

Pulls out the to-dos

Readings, assignments, deadlines, "bring X next week" — lifted into their own checklist instead of buried in prose where they get missed.

How it works

Read everything first. Then write.

The skill gets the whole arc before drafting a line — the trick that keeps early asides from being misread once you know where the lecture ends up.

1

Take in the transcript and any course material

Pasted text or an uploaded file — .txt, .vtt, .pdf, .docx. Slides and handouts come along as reference, not a second thing to summarize.

2

Reconstruct, don't re-transcribe

Where the audio mangled a term, the corrected version goes in. Genuinely unclear spots are kept and flagged inline — never silently invented.

3

Mine the slides page by page

A diagram, chart, or scanned document worth seeing gets embedded and captioned with its source slide. A clean definition on a slide sharpens the prose.

4

Hand back a formatted Word document

Overview, key topics, chronological notes, and a to-do checklist — real headings and styles, named for the lecture. Meeting recordings work the same way.

Install

Two ways in.

The same SKILL.md layout runs in both Claude Code and Codex — install however your agent prefers.

Claude Code · plugin

Add the marketplace

/plugin marketplace add IftekharulHaque/lecture-notes-skill /plugin install lecture-notes@lecture-notes-skill
Codex · or a script install

One line, no clone

# symlinks into ~/.claude and ~/.codex curl -fsSL https://raw.githubusercontent.com/\ IftekharulHaque/lecture-notes-skill/\ main/install.sh | bash