mcpField
P
pedagogy-review

pedagogy-review

github.com/pedrohcgsDocuments1.7k69 installsUpdated 4w ago
Repository

About pedagogy-review

pedagogy-review reviews lecture slides for teaching quality through a dedicated reviewer agent. It assesses 13 pedagogical patterns, the deck’s narrative and pacing, and student-facing considerations; the review is read-only.

Key features

  1. 01Checks 13 pedagogical patterns
  2. 02Assesses narrative arc and pacing
  3. 03Reviews visual rhythm and notation
  4. 04Considers prerequisites and student objections
  5. 05Saves a report without editing files

Use cases

  1. 01Review a lecture deck before teaching
  2. 02Identify pacing or narrative issues in slides
  3. 03Get recommendations on student prerequisites

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill pedagogy-review

After installing, type/pedagogy-reviewin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported