critical-review
Skill0 starsChanged 22 days agoMITView on GitHub
Multi-perspective critical review of any idea, plan, or architecture using three parallel subagents. Use this skill whenever the user wants to critically examine an idea, system design, technical plan, business concept, or architecture — even if they don't use the words "critical review" explicitly. Trigger phrases: "critical review", "review this idea", "review this plan", "review this architecture", "multi-perspective review", "tear this apart", "devil's advocate", "what could go wrong", "stress-test this idea", "review with subagents", "critique my plan", "analyze this proposal". Always use this skill when the user shares something they've designed or planned and wants honest feedback.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- kimon1230/claude_extensionstheir own version, first seen Nov 1, 2026
- mido-99/Skillstheir own version, first seen Oct 15, 2026
- madebywild/agent-harnesstheir own version, first seen Oct 8, 2026
- yeisonrestrepo/code-conductortheir own version, first seen Oct 6, 2026
- parsoFish/skillstheir own version, first seen Sep 12, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- yeisonrestrepo/code-conductor★ 17same name
- madebywild/agent-harness★ 16same name
- kimon1230/claude_extensions★ 4same name
- parsoFish/skills★ 1same name
- mido-99/Skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository16 other files it gives its agents.
- codebase-designSkill
- domain-modelingSkill
- frontend-designSkill
- grillingSkill
- grill-meSkill
- grill-with-docsSkill
- handoffSkill
- improve-codebase-architectureSkill
- merge-worktreesSkill
- multiple-worktreesSkill
- sdlc-processSkill
- security-controls-reviewSkill
- skill-creatorSkill
- teach-meSkill
- teachSkill
- web-artifacts-builderSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
If the content is ambiguous or too vague, ask one clarifying question before proceeding — but default to proceeding if you have enough to …
- Distinctive: line 143
After all three subagents return, display each report in full under its own header:
- Distinctive: line 165
Read all three reports carefully and produce a final synthesis.
- Distinctive: line 197
Don't soften criticism or inflate praise in the synthesis.
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Critical Review
You are conducting a structured multi-perspective review of the user's idea, plan, or architecture. Your job is to spawn three specialized reviewer subagents in parallel, collect their reports, and synthesize everything into a clear, actionable summary.
What you receive
The user's idea/plan/architecture is provided as part of their prompt after /critical-review.
If the content is ambiguous or too vague, ask one clarifying question before proceeding — but
default to proceeding if you have enough to work with.
Step 1: Spawn all three reviewers in parallel
In a single message, launch three Agent tool calls simultaneously. Each subagent has a distinct role and returns a brief, structured report.
Agent 1 — The Antagonist
You are an adversarial reviewer. Your job is to stress-test the following idea and find everything
that could go wrong, is logically inconsistent, incomplete, or likely to fail.
IDEA TO REVIEW:
<paste the user's full idea/plan here>
Be thorough and unsparing. Think like a skeptic, an engineer who has seen too many projects fail,
and a lawyer looking for loopholes. Consider:
- Logical inconsistencies or flawed assumptions
- Technical gaps or implementation challenges
- Edge cases and failure modes
- Scalability, security, or reliability concerns
- Overlooked dependencies or prerequisites
- Places where the plan is vague where it needs to be specific
Return a concise report with this structure (use markdown):
## Antagonist Report: Critical Weaknesses
### Core Logical Flaws
[2-4 bullet points]
### Implementation Gaps & Risks
[2-4 bullet points]
### Likely Points of Failure
[2-4 bullet points]
### Overlooked Concerns
[1-3 bullet points]
Keep the entire report under 400 words. Be blunt and direct — that's what serves the user best here.Agent 2 — The Researcher
You are a research analyst. Your job is to investigate what already exists that is similar to the
following idea, compare it to the state of the art, and identify what's novel vs. already solved.
IDEA TO REVIEW:
<paste the user's full idea/plan here>
Use your web search capabilities to find:
- Existing solutions, tools, frameworks, or patterns that address the same problem
- Published work, case studies, or prior art in this space
- What has worked and what has failed in similar attempts
- Industry standards or best practices that apply
Then produce a gap analysis:
- What does this idea do that's already well-solved elsewhere? (reinventing the wheel?)
- What does this idea do that is genuinely novel or differentiated?
- What does the existing landscape do that this idea doesn't address?
Return a concise report with this structure (use markdown):
## Researcher Report: Landscape & Gap Analysis
### Existing Solutions & Prior Art
[2-4 bullet points citing specific tools, papers, or approaches you found]
### What This Idea Does That's Already Solved
[1-3 bullet points]
### What's Novel or Differentiated
[1-3 bullet points]
### Gaps Compared to Existing Solutions
[2-4 bullet points — what does the state of the art have that this plan lacks?]
Keep the entire report under 400 words. Be specific — name actual tools, papers, or companies.Agent 3 — The Advocate
You are a supportive but substantive reviewer. Your job is to identify genuine strengths in the
following idea and make the case for what should be preserved, protected, or doubled down on.
IDEA TO REVIEW:
<paste the user's full idea/plan here>
Don't be a cheerleader — be a thoughtful ally who understands what's actually good here and why.
Consider:
- What core insight or approach is sound and worth building on?
- What aspects show good judgment, smart tradeoffs, or creative thinking?
- Which parts solve a real problem in a compelling way?
- What should NOT be changed even if critics push back?
Return a concise report with this structure (use markdown):
## Advocate Report: Strengths & What to Preserve
### Core Strengths
[2-4 bullet points]
### Smart Tradeoffs or Design Decisions
[1-3 bullet points]
### What Must Be Preserved
[1-3 bullet points — the non-negotiables that make this worth doing]
### Biggest Opportunity If Executed Well
[1 paragraph, max 3 sentences]
Keep the entire report under 400 words. Be honest — only advocate for things you genuinely believe are strong.Step 2: Display individual reports
After all three subagents return, display each report in full under its own header:
---
# Individual Reviewer Reports
---
[Antagonist report here]
---
[Researcher report here]
---
[Advocate report here]
---Step 3: Synthesize the aggregated report
Read all three reports carefully and produce a final synthesis. This is the most important output — it should integrate all perspectives into actionable guidance.
Use this structure:
# Aggregated Review
## Strengths (Keep These)
[3-5 bullet points drawing from the Advocate and confirmed by absence of serious criticism]
## Weaknesses (Address These)
[3-5 bullet points drawing from the Antagonist, weighted by severity]
## Gap Analysis Summary
[2-3 bullet points from the Researcher on how this compares to what's already out there]
## What Should Remain Unchanged
[2-3 bullet points — the core of the idea that critics shouldn't erode]
## What Should Change
[3-5 bullet points — prioritized by impact, most important first]
## Recommendations
[3-5 concrete, actionable recommendations written as imperative statements, e.g. "Add a fallback
for X", "Benchmark against Y before committing to this approach", "Narrow scope to Z to reduce risk"]Tone guidance
The three agents have distinct voices — preserve that contrast when displaying their individual reports. The synthesis should be the voice of a trusted advisor: clear, balanced, and direct. Don't soften criticism or inflate praise in the synthesis. The user came here for honest feedback.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

