Holistic pedagogical review of a lecture deck (`.qmd` or `.tex`). Checks narrative arc, prerequisite assumptions, worked examples, notation clarity, and deck-level pacing. Use when user says "pedagogy review", "does this teach well?", "is the flow right?", "will students follow?", "review the narrative", or before teaching a deck for the first time. Read-only; produces a report.
Install
npx skillscat add pedrohcgs/claude-code-my-workflow/pedagogy-review Install via the SkillsCat registry.
SKILL.md
Pedagogical Review of Lecture Slides
Perform a comprehensive pedagogical review.
Steps
Identify the file specified in
$ARGUMENTS- If no argument, ask user which lecture to review
- If just a name, look in
Quarto/orSlides/
Launch the pedagogy-reviewer agent with the full file path
- The agent checks 13 pedagogical patterns
- Performs deck-level analysis (narrative arc, pacing, visual rhythm, notation)
- Considers student perspective (prerequisites, objections)
The agent produces a report saved to:
quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.mdPresent summary to user:
- Patterns followed vs violated (out of 13)
- Deck-level assessments
- Critical recommendations (top 3-5)
Important Notes
- This is a read-only review — no files are edited
- Focuses on pedagogy not visual layout (use
/visual-auditfor that) - For a combined review, use
/slide-excellenceinstead