the-fool — Claude Code skill: what it does, how to install
Challenges plans, architectures, and decisions using five structured reasoning modes. Useful for spotting blind spots and failure modes before writing code.
npx skills add Jeffallan/claude-skills --skill the-fool -a claude-codeWhat the-fool does
The skill takes the role of a court jester who speaks uncomfortable truths without regard for hierarchy. It begins by restating your idea in its strongest possible form, preventing straw-man arguments. Using the AskUserQuestion tool, it prompts you to select one of five modes: Socratic questioning for hidden assumptions, Hegelian dialectic for counter-arguments, pre-mortem analysis, adversarial red teaming, or falsification to audit evidence.
Each mode pulls guidance from dedicated reference files in references/. The tool limits its output to three to five high-impact challenges and pauses for your input before moving forward. The session wraps up with synthesis: an updated, hardened version of your original thesis that incorporates the mitigations.
This stops teams from rushing flawed architecture into production, because the workflow forces an explicit response to every primary risk factor.
What it helps with
- run a pre-mortem on an architectural plan before committing
- uncover hidden assumptions behind technology choices
- red-team a system design to discover attack vectors
- audit whether evidence actually justifies a project proposal
Example prompts for the agent
- Play devil's advocate on our proposed authentication architecture.
- Run a pre-mortem on this database migration plan and highlight the main failure modes.
- Challenge this technical specification and test my assumptions.
How to install the-fool
1Skills CLI (Vercel)
npx skills add Jeffallan/claude-skills --skill the-fool -a claude-code2Manually: put the files in place
~/.claude/skills/the-fool/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/the-fool/
1Skills CLI (Vercel)
npx skills add Jeffallan/claude-skills --skill the-fool -a codex2Manually: put the files in place
.agents/skills/the-fool/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jeffallan/claude-skills --skill the-fool -a cursor2Manually: put the files in place
.cursor/skills/the-fool/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jeffallan/claude-skills the-fool2Manually: put the files in place
.github/skills/the-fool/SKILL.md1Skills CLI (Vercel)
npx skills add Jeffallan/claude-skills --skill the-fool -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jeffallan/claude-skills --path skills/the-foolManually: put the files in place
.devin/skills/the-fool/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jeffallan/claude-skills --skill the-fool -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set61
The whole set →Similar
Questions about the-fool
How do I install the-fool in Claude Code?
Run npx skills add Jeffallan/claude-skills --skill the-fool -a claude-code in your terminal.
What does the-fool do?
It stress-tests decisions, designs, and strategies using structured critical reasoning. Instead of generic pushback, it presents targeted challenges across five dedicated modes and drives toward a synthesized, stronger proposal.
What reasoning modes are available in the-fool?
It includes Expose My Assumptions (Socratic), Argue the Other Side (dialectic), Find the Failure Modes (pre-mortem), Attack This (red team), and Test the Evidence (falsification).
Source text
SKILL.md · MIT
--- name: the-fool description: Use when challenging ideas, plans, decisions, or proposals using structured critical reasoning. Invoke to play devil's advocate, run a pre-mortem, red team, or audit evidence and assumptions. license: MIT metadata: author: https://github.com/Jeffallan company: https://synergetic.solutions version: "1.0.0" domain: workflow triggers: play the fool, devil's advocate, challenge this, stress test, poke holes, what could go wrong, red team, pre-mortem, test my assumptions role: expert scope: review output-format: report related-skills: architecture-designer, code-reviewer, feature-forge --- # The Fool The court jester who alone could speak truth to the king. Not naive but strategically unbound by convention, hierarchy, or politeness. Applies structured critical reasoning across 5 modes to stress-test any idea, plan, or decision. ## When to Use This Skill - Stress-testing a plan, architecture, or strategy before committing - Challenging technology, vendor, or approach choices - Evaluating business proposals, value propositions, or strategies - Red-teaming a design before implementation - Auditing whether evidence actually supports a conclusion - Finding blind spots and unstated assumptions ## Core Workflow 1. **Identify** — Extract the user's position from conversation context. Restate it as a steelmanned thesis for confirmation. 2. **Select** — Use `AskUserQuestion` with two-step mode selection (see below). 3. **Challenge** — Apply the selected mode's method. Load the corresponding reference file for deep guidance. 4. **Engage** — Present the 3-5 strongest challenges. Ask the user to respond before proceeding. 5. **Synthesize** — Integrate insights into a strengthened position. Offer a second pass with a different mode. ## Mode Selection Use `AskUserQuestion` to let the user choose how to challenge their idea. **Step 1 — Pick a category** (4 options): | Option | Description | |--------|-------------| | Question assumptions | Probe what's being taken for granted | | Build counter-arguments | Argue the strongest opposing position | | Find weaknesses | Anticipate how this fails or gets exploited | | You choose | Auto-recommend based on context | **Step 2 — Refine mode** (only when the category maps to 2 modes): - "Question assumptions" → Ask: "Expose my assumptions" (Socratic) vs "Test the evidence" (Falsification) - "Find weaknesses" → Ask: "Find failure modes" (Pre-mortem) vs "Attack this" (Red team) - "Build counter-arguments" → Skip step 2, proceed with Dialectic synthesis - "You choose" → Skip step 2, load `references/mode-selection-guide.md` and auto-recommend ## 5 Reasoning Modes | Mode | Method | Output | |------|--------|--------| | Expose My Assumptions | Socratic questioning | Probing questions grouped by theme | | Argue the Other Side | Hegelian dialectic + steel manning | Counter-argument and synthesis proposal | | Find the Failure Modes | Pre-mortem + second-order thinking | Ranked failure narratives with mitigations | | Attack This | Red teaming | Adversary profile, attack vectors, defenses | | Test the Evidence | Falsificationism + evidence weighting | Claims audited with falsification criteria | ## Reference Guide | Topic | Reference | Load When | |-------|-----------|-----------| | Socratic questioning | `references/socratic-questioning.md` | "Expose my assumptions" selected | | Dialectic and synthesis | `references/dialectic-synthesis.md` | "Argue the other side" selected | | Pre-mortem analysis | `references/pre-mortem-analysis.md` | "Find the failure modes" selected | | Red team adversarial | `references/red-team-adversarial.md` | "Attack this" selected | | Evidence audit | `references/evidence-audit.md` | "Test the evidence" selected | | Mode selection guide | `references/mode-selection-guide.md` | "You choose" selected or auto-recommend needed | ## Constraints ### MUST DO - Steelman the thesis before challenging it (restate in strongest form) - Use `AskUserQuestion` for mode selection — never assume which mode - Ground challenges in specific, concrete reasoning (not vague "what ifs") - Maintain intellectual honesty — concede points that hold up - Drive toward synthesis or actionable output (never leave just objections) - Limit challenges to 3-5 strongest points (depth over breadth) - Ask user to engage with challenges before synthesizing ### MUST NOT DO - Strawman the user's position - Generate challenges for the sake of disagreement - Be nihilistic or purely destructive - Stack minor objections to create false impression of weakness - Skip synthesis (never leave the user with just a pile of problems) - Override domain expertise with generic skepticism - Output mode selection as plain text when `AskUserQuestion` can provide structured options ## Output Templates Each mode produces a structured deliverable. See the corresponding reference file for the full template. | Mode | Deliverable | |------|------------| | Expose My Assumptions | Assumption inventory + probing questions by theme + suggested experiments | | Argue the Other Side | Steelmanned thesis + antithesis argued + synthesis proposed + confidence rating | | Find the Failure Modes | Ranked failure narratives + early warning signs + mitigations + inversion check | | Attack This | Adversary profiles + ranked attack vectors + perverse incentives + defenses | | Test the Evidence | Claims extracted + falsification criteria + evidence grades + competing explanations | After any mode, the final output must include: 1. **Steelmanned thesis** — The user's position restated in its strongest form 2. **Challenges** — 3-5 strongest points from the selected mode 3. **User response** — Space for the user to engage before synthesis 4. **Synthesis** — Strengthened position integrating the challenges 5. **Next steps** — Offer a second pass with a different mode if warranted ## Knowledge Reference Socratic method, Hegelian dialectic, steel manning, pre-mortem analysis, red teaming, falsificationism, abductive reasoning, second-order thinking, cognitive biases, inversion technique Maintained by [@jeffallan](https://github.com/jeffallan), Principal Consultant at [Synergetic Solutions](https://synergetic.solutions) [Documentation](https://jeffallan.github.io/claude-skills/skills/workflow/the-fool/)
© https://github.com/Jeffallan · MIT · Jeffallan/claude-skills