Pedagogical Review of Lecture Slides

SkillAI & models

Lets your agent review a lecture deck for teaching quality, checking flow, pacing, examples, and notation.

Then ask your AI: use the Pedagogical Review of Lecture Slides skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

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 narrat

What this skill tells your AI

The instructions your AI receives, as published by pedrohcgs/claude-code-my-workflow in .claude/skills/pedagogy-review/SKILL.md and read by Ahel’s review.

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

Signals

GitHub stars
2k
Forks
3k
Last commit
Sep 2026
Advanced
Item type
skill
Key
pedagogy-review-pedrohcgs
Source
github.com/pedrohcgs/claude-code-my-workflow