Claude Skill

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?"

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download pedrohcgs-claude-code-my-workflow-.claude_skills_pedagogy-review-fe70774.zip · 0 KB

Install

skills CLI npx skills add https://github.com/pedrohcgs/claude-code-my-workflow/tree/main/.claude/skills/pedagogy-review
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install pedrohcgs-claude-code-my-workflow@llmmart
Git 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

  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
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.

No comments yet.

Reviews (0)

No reviews yet.