agentleFS
opelplepleopelpleple/meta-skills/devils-advocate/SKILL.md

devils-advocate

Skill0 starsChanged 5 months agoMITView on GitHub

Forcefully argues the opposite of whatever the user is already leaning toward, before they commit, to break confirmation bias and groupthink. Use this skill when the user has effectively decided and is seeking validation ("I'm going to do X", "we've decided to...", "just confirming this is right"), shows one-sided enthusiasm with no counterweight, faces a big or irreversible choice, says "talk me out of it", "devil's advocate", "argue the other side", or "what am I not seeing". Best when agreement would be too easy and the downside of being wrong is large.

36 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use validate-bib, review-r and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • luischanciSkill

    validate-bib

    Validate bibliography entries against citations in all manuscript files. Find missing entries and unused references.

    Also in 5 projects that use this

  • luischanciSkill

    review-r

    Run the R code review protocol on R scripts. Checks code quality, reproducibility, domain correctness, and professional standards. Produces a report without editing files.

    Also in 3 projects that use this

  • amaclullichSkill

    lit-review

    Literature review workflow: Search PubMed for papers, save to Zotero, generate summary tables. Use when user wants to find papers on a topic, build a reference collection, or create a literature summary.

    Also in 4 projects that use this

  • seikaikyoSkill

    interview-me

    需求不明時的意圖萃取訪談:一次一題、每題附上自己的猜測、聽出「真正想要 vs 覺得應該要」,直到能預測使用者反應(約 95% 信心)才動工。適用:需求缺少對象 / 動機 / 成功標準 / 約束,或使用者點名「訪談我」「先確認一下」「我們確定嗎」。明確自足的指示、純資訊查詢、機械性操作不適用。

    Also in 5 projects that use this

  • shanggqmSkill

    data-analysis

    数据分析技能,提供结构化的数据查询、统计分析和报告生成工作流。当用户需要查询数据库、进行数据统计分析、生成分析报告时使用。按规范输出原始数据、计算结果、Markdown报告和HTML可视化报告。

    Also in 4 projects that use this

  • JohnJBorenSkill

    product-manager

    Product development workflows, PRDs, prioritization frameworks, and roadmap planning

    Also in 3 projects that use this

  • +4 more from luischanci

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 30 edited versions we read keep these.

  • 5

    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
  1. Distinctive:

    Build the strongest possible opposing case: Not token objections — the case a brilliant, well-informed opponent would make.

    line 26
  2. Distinctive:

    Drop the mask and synthesize: After the assault, step out of the role: which objections actually survived scrutiny, and does the original …

    line 31
  3. Distinctive:

    No strawmen: you'd be proud to have the opponent endorse your version of their case.

    line 38
  4. Distinctive:

    Personal attacks: instead of attacking the decision.

    line 44
  5. Distinctive:

    Refusing to concede: when the original decision clearly survives — that destroys your credibility for next time.

    line 45

“Common” is measured: kept by at least 6 in 10 of the 30 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Devil's Advocate

Take the side the user isn't on and argue it as if your reputation depended on winning — so the decision has to survive a real fight before it's made.

When to use

  • The user has already decided and is really asking for a rubber stamp.
  • Enthusiasm is high and dissent is absent (a classic groupthink signature).
  • The choice is big, expensive, or hard to reverse.
  • Everyone in the room agrees — which is itself a warning sign.
  • The user explicitly asks to be talked out of it.

When NOT to use

  • The decision is small, cheap, and reversible — just let them proceed.
  • The user is fragile or already spiraling in self-doubt; this adds noise, not signal.
  • A choice is already locked and unchangeable; arguing against it now only demoralizes.
  • Matters of personal values/taste where there's no "wrong" to argue.

The method

  1. Pin down the exact position. State precisely what the user has decided, in one sentence, so you're arguing against the real thing, not a strawman.
  2. Declare the role openly. Say you're going to argue the opposite case hard, on purpose — it's a stress test, not your actual recommendation (yet). This keeps it from feeling like an ambush.
  3. Build the strongest possible opposing case. Not token objections — the case a brilliant, well-informed opponent would make. Lead with the argument you'd least want to hear.
  4. Attack the foundation, not just the edges. Question the premise itself: "What if the problem you're solving isn't the real problem?" The most valuable counter often invalidates the whole frame.
  5. Marshal the opposite evidence. Find the data, base rates, and precedents that point the other way. Cite how similar decisions have gone wrong for others.
  6. Name what would have to be true for the user to be right — and how confident they actually are in each of those. Shaky load-bearing beliefs are the soft spots.
  7. Offer the strongest alternative, not just "don't." A good devil's advocate proposes the path the user is dismissing too quickly.
  8. Drop the mask and synthesize. After the assault, step out of the role: which objections actually survived scrutiny, and does the original decision still stand? Honesty here is the whole point.

What good looks like

  • The opposing case is strong enough that the user genuinely pauses.
  • You attack the premise at least once, not only the execution.
  • The user ends up with a better-reasoned version of their decision — or a changed one.
  • You clearly separate "advocate mode" from your honest final read.
  • No strawmen: you'd be proud to have the opponent endorse your version of their case.

Anti-patterns

  • Weak objections you can both easily dismiss — theater, not stress-testing.
  • Never dropping the mask, leaving the user thinking you actually oppose them.
  • Contrarianism for its own sake on decisions that are obviously fine.
  • Personal attacks instead of attacking the decision.
  • Refusing to concede when the original decision clearly survives — that destroys your credibility for next time.

Example

User: "We're going all-in on the Forex-only pivot; I just want to lock it in." Advocate mode: "Let me argue against it as hard as I can. Premise attack: you're assuming focus beats breadth — but your moat was coverage across markets; narrowing hands every adjacent vertical to a competitor for free. Base rate: most 'focus' pivots that abandon a working revenue line underestimate how much of current revenue is cross-sell from the parts you're cutting. For you to be right, three things must hold: (a) Forex demand alone sustains the team, (b) the cut segments aren't subsidizing it, (c) re-entry later is possible. How sure are you about (b)? Strongest alternative: keep Forex as the spearhead but don't delete the rest — sequence it." Mask off: "Honestly, the demand case is solid; the one objection that survives is (b) — verify the cross-sell revenue before you cut, or the pivot could starve itself."

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.