clearsmog

pedagogy-review

Run holistic pedagogical review on academic slides and educational documents. Checks narrative arc, student prerequisites, worked examples, notation clarity, and deck pacing. Supports .tex, .qmd, and .typ slide decks.

clearsmog 2 Updated 3mo ago
GitHub

Install

npx skillscat add clearsmog/claude-skills/pedagogy-review

Install via the SkillsCat registry.

SKILL.md

Pedagogical Review of Slides and Educational Documents

Perform a comprehensive pedagogical review. Supports Beamer (.tex), Quarto (.qmd), and Typst (.typ) slide decks.

Steps

  1. Identify the file specified in $ARGUMENTS

    • If no argument, ask user which lecture to review
    • If just a name, look in Quarto/ or Slides/
  2. 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)
  3. The agent produces a report saved to:
    quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md

  4. Present 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-audit for that)
  • For a combined review, use /slide-excellence instead