lecture-notes-enhancementlisted
Install: claude install-skill xjsongphy/skills
# Lecture Notes Enhancement
## Shared narrative rules
Read and follow [the shared narrative and evidence rules](../shared/narrative-and-evidence.md). 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 md-report-writer narrative style (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 deriva