Install
openclaw skills install @deciqai/hanlons-razorActivate when: someone feels a colleague/partner/company did something on purpose to hurt them; a team believes another side is acting in bad faith; someone is about to escalate based on assumed malicious intent; a pattern of bad outcomes is being labeled a coordinated attack. Do NOT activate when: concrete documented evidence of malice already exists; the cost of being wrong about non-malice is catastrophic (e.g., safety-critical or abusive-relationship context).
openclaw skills install @deciqai/hanlons-razorBefore assuming someone hurt you on purpose, construct the version where they made a mistake — and see how much evidence it explains. The razor is a Bayesian prior, not a proof; override it when concrete evidence of malice arrives. Human attribution systematically over-weights intent (fundamental attribution error); most hostile-seeming acts are incompetence, miscommunication, or asymmetric information.
Composes with bayesian-reasoning, abductive-reasoning, occams-razor, critical-thinking.
Not when: concrete evidence of malicious intent exists; cost of being wrong is catastrophic; power imbalance makes "they probably didn't mean it" an abuse-enabling stance.
In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
Step 1 — Describe the action and harm (factual, not interpretive)
- What was done: <specific, factual>
- Harm to me: <concrete>
- Gut attribution: <what your instinct is saying>
Step 2 — Construct the non-malice explanation
- Bad information they had: / Didn't realize: / Optimizing for: / Under pressure from:
- Coverage: <% of observed behavior this explains>
Step 3 — Name what malice would additionally require
- Info they'd need: / Motivation at your expense: / Harm predictable from their position?
Step 4 — Choose starting posture · Step 5 — Set override signal · Step 6 — Hold prior until evidence changes it
- Prior: <mistake / malice> · Starting posture: · First move: · Override trigger:
# Hanlon's Razor Analysis: <incident>
Mistake explanation + coverage % | Malice extra assumptions | Prior | Override signal | First action
→ Method in Action: Hanlon's Submission 1980; Heinlein's 1941 Articulation
| Situation | Default malice | Likely incompetence |
|---|---|---|
| Colleague sends harsh email | "They're undermining me" | Tired, didn't notice tone |
| Manager ignores your work | "They don't value me" | Overloaded, missed the update |
| Customer complains publicly | "Trying to extort us" | Real issue, tried other channels |
| Investor passes after diligence | "Were never serious" | Portfolio rebalancing |
| Co-founder makes unilateral decision | "Cutting me out" | Time pressure, assumed approval |
→ Primary sources: references/sources.md
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] Apply razor then ignore mounting evidence of malice | It's a prior, not a permanent ban on updating. |
| [D] Use razor to avoid hard conversations | It recommends a clarifying conversation, not silence. |
| [D] Apply razor across power asymmetries | Boss-harming-subordinate: power shifts the calculus. |
| [D] Invoke razor on yourself to dodge accountability | "Didn't mean to" doesn't undo the harm. |
| [D] Stop investigating once incompetence is identified | Incompetence-caused harm still requires response. |
| [D] Use razor to gaslight someone who was genuinely harmed | Attribution ≠ override of their lived experience. |
| → Add [O] entries here after each real use — paste the actual failure pattern | What went wrong and why |
Part of deciqAI Knowledge Skills — open-source thinking skills that make rigor executable for AI agents. Built by deciqAI · https://deciqai.com · Contributions welcome — see the template at the repo root.