← LeaderboardThe Skill Leaderboard

pedagogy-review

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.

Published by pedrohcgs ↗pedrohcgs/claude-code-my-workflow

Try your first task

pedagogy-review

Start a fresh conversation. Replace the highlighted placeholders.

Use pedagogy-review to review [lecture deck .qmd or .tex file] for narrative arc, prerequisite assumptions, worked examples, notation clarity, and pacing; return the read-only report summary and top critical recommendations.

Required inputs

  • [lecture deck .qmd or .tex file]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: pedagogy-reviewdescription: 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.argument-hint: "[QMD or TEX filename]"allowed-tools: ["Read", "Grep", "Glob", "Write", "Agent", "Task"]disallowed-tools: ["Edit", "MultiEdit"]

Pedagogical Review of Lecture Slides

Perform a comprehensive pedagogical review.

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 returns its report (the agent is read-only); this skill saves it 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