mcpField
D
devils-advocate

devils-advocate

github.com/pedrohcgsDocuments1.7k54 installsUpdated 5w ago
Repository

About devils-advocate

devils-advocate is a skill for critically reviewing lecture slide decks through 5–7 focused pedagogical questions. It examines sequencing, prerequisites, notation, cognitive load, and other teaching considerations, with suggested resolutions.

Key features

  1. 01Generate 5–7 specific challenges
  2. 02Review ordering and prerequisites
  3. 03Identify notation conflicts and cognitive load
  4. 04Include suggested resolutions

Use cases

  1. 01Question the structure of a lecture deck
  2. 02Check whether slides assume untaught material
  3. 03Find notation conflicts across lectures

Install

Copy the command and run it in a terminal.

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

After installing, type/devils-advocatein Claude Code to confirm it loaded.

Details

From the project README

Devil's Advocate Review

Critically examine a slide deck and challenge its design with 5-7 specific pedagogical questions.

Philosophy: "We arrive at the best possible presentation through active dialogue."

Setup

  1. Read the target file (the lecture being challenged)
  2. Read the knowledge base in .claude/rules/ for notation conventions and narrative arc
  3. If applicable, read adjacent lectures for narrative continuity

Challenge Categories

Generate 5-7 challenges from these categories:

1. Ordering Challenges

"Could students understand this better if we showed X before Y?"

2. Prerequisite Challenges

"Do students have the background for this notation at this point?"

3. Gap Challenges

"Should we include an intuitive example before this formal proof?"

4. Alternative Presentation Challenges

"Here are 2 other ways to visualize/present this concept."

5. Notation Conflict Challenges

"This symbol conflicts with earlier lecture usage."

6. Cognitive Load Challenges

"This slide has too many new symbols. Can we split?"

7. Book Vision Challenges

"If this becomes a book chapter, does this section stand alone?"

Output Format

# Devil's Advocate: [Lecture Title]

## Challenges

### Challenge 1: [Category] — [Short title]
**Question:** [The specific pedagogical question]
**Why it matters:** [What could go wrong]
**Suggested resolution:** [Specific action]
**Slides affected:** [Numbers or titles]
**Severity:** [High / Medium / Low]

[Repeat for 5-7 challenges]

## Summary Verdict
**Strengths:** [2-3 things done well]
**Critical changes:** [0-2 changes before teaching]
**Suggested improvements:** [2-3 nice-to-have changes]

Principles

  • Be specific: Reference exact slides and notation
  • Be constructive: Every challenge has a suggested resolution
  • Be honest: If the deck is good, say so
  • Prioritize: Notation conflicts > missed metaphors
  • Think like a student: Where do they get lost?

Comments

Markdown supported