By name: pedagogy-review description: Run a holistic narrative review on a Quarto report or Markdown document. Checks reader prerequisites, worked examples, notation clarity, structural arc, and pacing. disable-model-invocation: true argument-hint: "[QMD or MD filename]" allowed-tools: ["Read", "Grep", "Glob", "Write", "Task"]
Pedagogical Review of a Report or Document
Perform a holistic narrative review of a Quarto report (reports/*.qmd), a replication report (quality_reports/*.md), or any document where pedagogical clarity matters (audience comprehension, motivation, worked examples, notation discipline).
Steps
Identify the file specified in
$ARGUMENTS- If no argument, ask the user which file to review
- If just a name, look in
reports/, thenquality_reports/, then repo root
Launch the pedagogy-reviewer agent with the full file path
- The agent checks the standard pedagogical patterns (motivation, prerequisites, worked examples, notation consistency, narrative arc, pacing)
- For an analysis report: also verifies that econometric assumptions and identification claims are stated clearly enough for a non-coauthor reader
The agent produces a report saved to:
quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.mdPresent a summary to the user:
- Patterns followed vs. violated
- Document-level assessments (arc, pacing, notation)
- Top 3–5 critical recommendations
Important Notes
- This is a read-only review — no files are edited
- For econometric specification correctness, use the
econometric-revieweragent (or/review-stata) instead - For grammar/typos, use
/proofreadinstead