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?"
Install
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow/tree/main/.claude/skills/pedagogy-review
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install pedrohcgs-claude-code-my-workflow@llmmart
git clone https://github.com/pedrohcgs/claude-code-my-workflow.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole pedrohcgs/claude-code-my-workflow collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
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 returns its report (the agent is read-only); this skill saves it to:
quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.mdPresent 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
Files (claude-code-my-workflow)
-
SKILL.md 1.6 KB
--- name: pedagogy-review description: 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. argument-hint: "[QMD or TEX filename]" allowed-tools: ["Read", "Grep", "Glob", "Write", "Agent", "Task"] disallowed-tools: ["Edit", "MultiEdit"] --- # 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 (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.