Pedagogy review
Skill pedrohcgs/claude-code-my-workflow/.claude/skills/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.From its SKILL.md
npx -y skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
1.5 KB, 253 tokens by cl100k_base, as published. Nobody here has run it
Pedagogical Review of Lecture Slides
Perform a comprehensive pedagogical review.
Steps
-
Identify the file specified in
$ARGUMENTS- If no argument, ask user which lecture to review
- If just a name, look in
Quarto/orSlides/
-
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)
-
The agent produces a report saved to:
quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md -
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-auditfor that) - For a combined review, use
/slide-excellenceinstead
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.