design mediaby brycewang-stanford
Pedagogical Review of Lecture Slides
brycewang-stanford/pedagogy-review
Run holistic pedagogical review on lecture slides. Checks narrative arc, student prerequisites, worked examples, notation clarity, and deck pacing.
What it changes
Passed 12 of 19 test cases with the skill, and 5 of 19 without it.
Without skill27%
With skill64%
Checks it passed that the model alone missed
- Analyzes potential student objections
- Looks for the file inside the Quarto/ directory
- States that 13 pedagogical patterns are evaluated
and 7 more in the full report
9 fixed5 passed either way7 still failing1 broke
- Pass-rate lift
- +36 pp
- Tokens
- -46%
- Agent turns
- 0%
- Response time
- -47%
Model gemini-3.6-flashMeasured 8/9/2026v114 of 22 cases passed with skill · 19 comparable
See it in action
One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.
PromptHow many teaching patterns does the slide reviewer agent evaluate across the deck?
What was checked, without and with the skill| Checked | Without skill | With skill |
|---|
| States that 13 pedagogical patterns are evaluated | Missed | Passed |
|---|
What's inside
The instructions your model reads when the skill loads.
SKILL.md28 linessingle file
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/ or Slides/
-
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-audit for that)
- For a combined review, use
/slide-excellence instead
Track record
Benchmark
12 / 19
test cases passed, vs 5 / 19 without
Adoption
- Users
- 0
- Times used
- 0
Safety and source details
SkillSafety
✓ 3 of 3 passed✓Code scan15 of 15 checks clean
0 critical · 0 warning · 0 info — scanner v4 — 8/2/2026
View 15 scanner checks
live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing
✓IntentSafe
LLM judge · does the skill do what it claims
✓ContentClean
LLM judge · policy & harmful-content review
Source
Importedbrycewang-stanford / Auto-Empirical-Research-Skills
skills/12-pedrohcgs-claude-code-my-workflow/dot-claude/skills/pedagogy-review/SKILL.md
View on GitHub ↗License NOASSERTIONImported 8/2/2026Version v1