devils-advocate

Generate 5-7 targeted challenges to critique document design.

2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/clearsmog/claude-skills --skill devils-advocate-clearsmog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devils-advocate
Source: https://github.com/clearsmog/claude-skills/tree/main/devils-advocate
Command: npx skills add https://github.com/clearsmog/claude-skills --skill devils-advocate-clearsmog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps educators and reviewers systematically critique document design by generating 5-7 focused questions to improve structure, flow, and pedagogy.

Core Features & Use Cases

  • Generate a rubric-style set of 5-7 challenges tailored to slide decks (.tex, .qmd, .typ) and documents.
  • Provide categorized prompts (ordering, prerequisites, cognitive load) to guide improvements.
  • Output a structured, publish-ready evaluation that can be used in course feedback or peer reviews.

Quick Start

Provide a target slide deck filename or document title to generate 5-7 critical prompts for improvement.

Frequently Asked Questions about devils-advocate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate critical questions to review slide deck design?

To critique slide deck design, provide a target filename or document title to generate 5-7 targeted challenges. These questions evaluate structure, flow, and pedagogy to guide document improvements.

What is document design critique in peer review?

Document design critique in peer review is a structured evaluation that generates 5-7 focused questions to improve pedagogy. It helps educators systematically identify issues in ordering, prerequisites, and cognitive load.

Can I use this to evaluate .tex, .qmd, and .typ slide decks?

Yes, you can use this to evaluate .tex, .qmd, and .typ slide decks. The skill applies a frontmatter-driven prompt to these specific formats to output a publish-ready structured evaluation for course feedback.

How do I systematically critique document flow and structure?

You systematically critique document flow and structure by applying categorized prompts for ordering, prerequisites, and cognitive load. This generates a rubric-style set of 5-7 challenges tailored to your specific document or slide deck.

What are the limitations of using automated prompts for pedagogical review?

A limitation of automated prompts for pedagogical review is that they generate exactly 5-7 targeted challenges based on frontmatter-driven inputs. Users must manually apply these structured questions to their documents to achieve actual design improvements.