lecture-notes-enhancementlisted
Install: claude install-skill xjsongphy/skills
# Lecture Notes Enhancement
## Shared narrative rules
Load the `writer` skill's `references/common/writing.md` module. Keep process
notes and defensive source disclaimers out of the lecture notes; state source
limitations only when they affect the explained concept.
## Overview
Systematic process for cross-referencing recordings, PPTs, and existing notes to identify gaps and enhance lecture notes with narrative-first writing. Uses parallel subagents for efficiency.
## When to Use
**Use when:**
- Enhancing existing lecture notes (讲义.md) with course recordings and PPTs
- Course has multiple source materials (records/, extracted/, existing notes)
- Need systematic gap identification and content supplementation
- Following the `writer` Markdown narrative route (narrative flow before technical content)
**Don't use when:**
- Creating lecture notes from scratch (use brainstorming + writing-plans instead)
- Simple formatting or proofreading (use simplify skill instead)
- Single source material only (direct editing is sufficient)
## Nature of Source Materials
Each source type has distinct role and limitations:
**Slides (PPT extracted/) — Simplified outline only.** Contain key formulas and section outlines — the final results, not the path to them. No detailed derivations, intermediate steps, or physical intuition. Treat slides as a *what* checklist, not the full content.
**Recordings (records/) — Full content with caveats.** Contain detailed derivations, step-by-step reason