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 Updated 2 repo stars
Terminal recording: Claude Code runs /qk-skills:diagram on a pull-request flowchart, writes the D2 source, renders it, checks the image and saves light and dark

File contents

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

clearsmog/claude-skills commit 68f63187e8

Frequently asked questions

npx get-skill add clearsmog/pedagogy-review