Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
pedrohcgs avatar

Devils Advocate

  • 48 installs
  • 1.4k repo stars
  • Updated June 10, 2026
  • pedrohcgs/claude-code-my-workflow

Helps with ai & agent building tasks.

About

devils-advocate is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

  • devils-advocate
  • AI & Agent Building
  • AI-coding skill

Devils Advocate by the numbers

  • 48 all-time installs (skills.sh)
  • +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #7,437 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill devils-advocate

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs48
repo stars1.4k
Last updatedJune 10, 2026
Repositorypedrohcgs/claude-code-my-workflow

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

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?

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.