Install
openclaw skills install @deciqai/black-swanActivate when: user says 'this can't happen,' 'never happened in N years,' 'our models say it's near-zero'; user is stress-testing a strategy or portfolio against extreme scenarios; someone mentions fat tails, Taleb, narrative fallacy, or turkey problem; a past catastrophic event is being analyzed and it 'seemed obvious in hindsight.' Do NOT activate when: the domain is genuinely thin-tailed (human heights, daily caloric intake); user is invoking 'black swan' as an excuse for a planning failure they could have avoided.
openclaw skills install @deciqai/black-swanTaleb (2007): a black swan is (1) outside all prior expectations, (2) extreme impact, (3) obvious in hindsight only. Many domains (markets, careers, tech) are Extremistan (power-law / fat-tail), yet most models assume Mediocristan (Gaussian / thin-tail) — underestimating tail risk by orders of magnitude. The Turkey Problem: 1000 days of feeding creates confidence; day 1001 is Thanksgiving.
Composes with antifragile, probabilistic-thinking, inversion, first-principles.
Use when: a risk model assumes normality in a fat-tailed domain; "never happened in N years" dismisses tail risk; strategy assumes stable environment; you're constructing a retrospective narrative; stress-testing against extreme scenarios; someone says "fat tails / Taleb / narrative fallacy / turkey problem."
Not when: domain is genuinely Mediocristan; "black swan" is being used to excuse a foreseeable planning failure.
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]
Sample 30+ historical observations. Bell-shaped → Mediocristan. Power-law / long-tail → Extremistan. Specific test: does the largest observation dominate the sum of the others? If yes → Extremistan.
For each assumption: does it imply "normal distribution"? Use "rarely happens" or "the average is X"? Ignore outliers dominating outcomes? If yes and domain is Extremistan — structurally vulnerable.
Tail survival ≠ tail prediction. Options: Bounded downside (no single event breaks you), Optionality (many small bets, convex upside), Redundancy (multiple suppliers / revenue lines), Skin in the game (decision-makers bear tail consequences). See antifragile.
Resist "we should have seen it coming." Ask: what was the epistemic state of well-informed people the day before? The "obvious in retrospect" feeling is hindsight bias, not predictability. Design for the category, not the specific next event.
# Black Swan Audit: <system / decision>
## Domain: Extremistan / Mediocristan / mixed — Evidence: <…>
## Hidden Mediocristan assumptions: <list>
## Tail-survival design: bounded downside via <…> | optionality via <…> | redundancy via <…>
## Narrative-fallacy check: past event <…> | story told <…> | actual epistemic state <…>
→ Method in Action: Long-Term Capital Management Collapse, 1998
Extremistan (fat-tail) domains where Gaussian models consistently fail: stock returns, VC outcomes, tech market caps, geopolitical events, pandemic frequency, cyber breaches, catastrophe insurance claims, book sales. Mediocristan (safe to use averages): human heights, daily caloric intake, commute times on normal days.
→ Primary sources: references/sources.md
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] "It's never happened in N years, so it can't happen" | The turkey problem. N years of data is consistent with both impossible and "imminent." |
| [D] "We have sophisticated models" | Models that assume the wrong distribution are sophisticated in the wrong direction. |
| [D] Constructing a confident retrospective narrative | Hindsight bias. The actual epistemic state before the event was much less clear. |
| [D] "Insurance / hedges / risk management protect us" | If those mechanisms also use Mediocristan assumptions, they fail in the same event. |
| [D] Predicting the specific next black swan | Not possible. Predict the category; design for tail-event survival. |
| [D] Treating "black swan" as an excuse for poor planning | Grey swans get mislabeled as black swans by people who failed to plan. |
| [D] Diversification across correlated risks | True diversification is across uncorrelated risks. In crises, correlations jump toward 1. |
| → 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.