lesson-notes

name	lesson-notes
description	Generate structured study notes from course materials (transcripts, slides, readings). Creates module overviews, adds frontmatter to slide extracts, and cross-links concepts.
argument-hint	<module_number>

Lesson Notes Generator

Generate structured study notes from course module materials.

Usage

/lesson-notes <module_number>

Example: /lesson-notes 4 to process Module 4

Input Requirements

The module folder M{X}/ should contain:

• Video transcript (.vtt, .srt, or .txt)
• Slide extracts (.md files converted from PDFs)
• Any readings or supplementary materials

Process

Step 1: Read All Source Materials

Read M{X}/*.vtt, M{X}/*.md, M{X}/*.txt

Identify:

• Main transcript file
• Slide markdown files
• Supplementary readings

Step 2: Create Module Overview

Create M{X}/Module_{XX}_{Topic}.md using the template from CLAUDE.md.

Required sections:

1. Frontmatter

   ---
   title: "Module Title"
   module: X
   course: "Course Name"
   date_processed: YYYY-MM-DD
   tags:
     - topic-tags
   ---
   

2. Module Materials

   • Links to slides, videos, transcripts
   • External resource links
   • Related modules

3. Video Timestamps

   | Timestamp | Topic |
   |-----------|-------|
   | `0:05:30` | Topic introduction |
   

4. Executive Summary

   • 2-3 sentences capturing key takeaways

5. Key Concepts Table

   | Concept | Definition | Related To |
   |---------|-----------|------------|
   

6. Detailed Lesson Notes

   • Organized by topic
   • Use callout boxes for key insights
   • Preserve instructor terminology

7. Frameworks & Models

   • Deep dives on specific frameworks covered
   • Include diagrams where available

8. Relationships & Links

   • Prerequisites
   • Builds toward
   • Related concepts

9. Study Questions

   • 5 questions spanning Bloom's taxonomy
   • Recall → Comprehension → Application → Analysis → Evaluation

Step 3: Extract Video Timestamps

Scan transcript for:

• Topic transitions ("Now let's talk about...")
• Key concept introductions
• Examples and case studies
• Exercises or activities

Create timestamp table in module notes.

Step 4: Update Slide Extracts

Add to each slide markdown file:

---
title: "Slide Deck Title"
type: slides
module: X
source: "filename.pdf"
tags:
  - topic-tags
---

> [!info] Related Materials
> - [[Module_XX_Topic|Module Overview]]
> - [[Concepts/KeyConcept|Key Concept]]

> [!note] Critical Insight
> Key takeaway or framework summary from this deck

---
(Original slide content follows)

Step 5: Create Concept Notes

For new frameworks, people, or key terms, create notes in Concepts/:

Template:

---
title: "Concept Name"
aliases:
  - Alternative Name
  - Abbreviation
type: concept
category: framework|person|domain|methodology
tags:
  - relevant-tags
---

# Concept Name

## Definition

Brief definition.

## Key Characteristics

- Point 1
- Point 2

## Related Concepts

- [[Concepts/Related1|Related 1]]
- [[Concepts/Related2|Related 2]]

## Module Reference

- [[M{X}/Module_XX_Topic|Module X]] - Where this is covered

Step 6: Cross-Link Everything

Use consistent link formats:

• [[Concepts/Name|Display]] for concept references
• [[M{X}/Module_...|Module X]] for module references
• [[filename]] for same-folder references

Callout Conventions

> [!note] Key Insight
> Important principle or concept

> [!warning] Common Mistake
> Anti-pattern or pitfall to avoid

> [!example] Case Study: Name
> Real-world application

> [!tip] Practical Application
> How to apply this concept

> [!info] Connection
> How this relates to other topics

Output Checklist

After running this skill, verify:

• Module overview created with all sections
• Video timestamps extracted
• Slide extracts have frontmatter
• New concepts added to Concepts/ folder
• All wiki-links resolve correctly
• External resources captured
• Study questions span difficulty levels

Customization

Modify this skill for your course by:

1. Updating the frontmatter fields
2. Adjusting section requirements
3. Adding course-specific terminology
4. Modifying the concept categories