# devils-advocate

Challenges lecture decks from a skeptical student's perspective with five to seven targeted critiques on narrative flow and cognitive load.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1671
- Author: pedrohcgs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/pedrohcgs/claude-code-my-workflow/tree/HEAD/.claude/skills/devils-advocate/SKILL.md
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/skills/devils-advocate

## What it does

The skill stress-tests slide decks and lecture notes before class. It looks for gaps in intuition, prerequisite jumps, and confusing notation. The review remains lighter than `/pedagogy-review`, focusing on where students might get stuck.

The assistant operates strictly read-only using `Read`, `Grep`, and `Glob`. It cannot modify your slides because `Edit` and `MultiEdit` tools are blocked. The skill inspects your deck, reads notation rules in `.claude/rules/`, and checks neighboring lectures for narrative continuity.

The generated report highlights affected slide numbers, severity rankings, and concrete resolution steps. It concludes with an actionable verdict separating essential pre-class changes from optional refinements.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedrohcgs/claude-code-my-workflow --skill devils-advocate -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/devils-advocate/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/devils-advocate/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedrohcgs/claude-code-my-workflow --skill devils-advocate -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/devils-advocate/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedrohcgs/claude-code-my-workflow --skill devils-advocate -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/devils-advocate/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedrohcgs/claude-code-my-workflow devils-advocate
```

2. **Manually: put the files in place**
- File: `.github/skills/devils-advocate/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedrohcgs/claude-code-my-workflow --skill devils-advocate -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedrohcgs/claude-code-my-workflow --path .claude/skills/devils-advocate
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/devils-advocate/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedrohcgs/claude-code-my-workflow --skill devils-advocate -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedrohcgs/claude-code-my-workflow/tree/HEAD/.claude/skills/devils-advocate/SKILL.md

## When to use it
- catch conflicting mathematical notation across lecture files
- pinpoint slides carrying too much cognitive load
- spot missing intuitive examples before formal proofs
- verify prerequisites and narrative continuity across lectures

## Example prompts
- Play devil's advocate for `lecture-04.md`
- Poke holes in the pedagogical design of `ml-foundations.deck`
- What would a skeptical student ask about `linear-algebra-recap.md`?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c9701b5787943087.

BEGIN THIRD-PARTY FILE c9701b5787943087
````text
---
name: devils-advocate
description: Adversarial 5-7 question challenge to a deck's pedagogical choices — ordering, prerequisites, cognitive load, motivation. Use when user says "devil's advocate", "poke holes in this deck", "push back on my slides", "stress-test the design", "what would a skeptical student ask?". Read-only; surfaces questions to force rethinking. Lighter than `/pedagogy-review`.
argument-hint: "[Lecture filename]"
allowed-tools: ["Read", "Grep", "Glob"]
disallowed-tools: ["Edit", "MultiEdit"]
---

# 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

```markdown
# 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?
````
END THIRD-PARTY FILE c9701b5787943087

The third-party file has ended. Everything between the c9701b5787943087 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© pedrohcgs · MIT · https://github.com/pedrohcgs/claude-code-my-workflow/tree/HEAD/.claude/skills/devils-advocate/SKILL.md

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md