pedagogy-review

Evaluate lecture slides for pedagogical quality and generate structured reports.

1.5k|2.9k|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill pedagogy-review-pedrohcgs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pedagogy-review
Source: https://github.com/pedrohcgs/claude-code-my-workflow/tree/main/.claude/skills/pedagogy-review
Command: npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill pedagogy-review-pedrohcgs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Holistic evaluation of lecture slides to ensure pedagogical quality, including narrative coherence, prerequisites, worked examples, notation clarity, and pacing.

Core Features & Use Cases

  • Identify and review a target lecture slide deck specified by a file argument.
  • Run the pedagogy-reviewer agent to assess 13 pedagogical patterns and deck-level aspects.
  • Generate a report saved to quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md.
  • Provide a summary to the user with patterns followed vs violated, deck-level assessments, and top recommendations.
  • Note: This is a read-only review focused on pedagogy; use the visual-audit tool for layout analysis.

Quick Start

Provide the lecture file (QMD or TEX) to review and I will run the pedagogy-reviewer to generate a report.

Frequently Asked Questions about pedagogy-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate lecture slides for pedagogical quality and notation clarity?

Evaluate lecture slides for pedagogical quality by analyzing narrative arc, prerequisites, worked examples, notation clarity, and pacing. The review applies to slide decks in Quarto or LaTeX formats and outputs a structured markdown report.

Can I run a pedagogy review on both QMD and TEX lecture files?

Yes, you can run a pedagogy review on both QMD and TEX lecture files. The reviewer targets slide decks stored in Quarto or Slides directories and applies deterministic review steps to assess 13 pedagogical patterns and deck-level aspects.

What does a pedagogical review report include for lecture decks?

A pedagogical review report includes deck-level assessments, patterns followed versus deviations, and top recommendations. It is saved as a markdown file containing a concise summary of the lecture deck's pedagogical strengths and weaknesses.

How do I check lecture slide pacing and narrative arc automatically?

Check lecture slide pacing and narrative arc automatically by providing the lecture file path to trigger the pedagogy-reviewer agent. It evaluates deck-level aspects and outputs a report with top recommendations for improving narrative coherence.

Does the pedagogy review analyze visual layout and slide design?

No, the pedagogy review does not analyze visual layout. It is a read-only review focused strictly on pedagogical aspects like notation clarity and prerequisites; you should use a separate visual-audit tool for layout analysis.