# Pedagogy Review

Holistic pedagogical review of a lecture deck (`.qmd` or `.tex`).

- Repository: https://github.com/pedrohcgs/claude-code-my-workflow (1676 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-09-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -g -a claude-code -y`
Codex: `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -g -a codex -y`
Cursor: `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -g -a cursor -y`
Gemini CLI: `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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