agentleFS
deciqAIdeciqAI/knowledge-skills/black-swan/SKILL.md

black-swan

Skill13 starsChanged 4 months agoMITView on GitHub

Activate 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.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    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:

    Check fit: genuinely thin-tailed domain (heights, commutes)?

    line 29

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Black Swan

Overview

Taleb (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.

When to Use

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"; a thesis rests on a one-directional trend like "AI demand can only go up," AI-capex payoff, or concentrated mega-cap / AI-bubble exposure.

Not when: domain is genuinely Mediocristan; "black swan" is being used to excuse a foreseeable planning failure.

Coaching Novices (Adaptive Front Door)

  • Engine mode: user has a concrete case → run The Process directly.
  • Coach mode: user is unfamiliar or has no concrete case → guide step by step.

In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.

  1. One-line: some domains have rare events that dominate everything (markets, careers, tech); models assuming "normal" distributions miss them — and we always invent stories afterward that make them look predictable.
  2. Check fit: genuinely thin-tailed domain (heights, commutes)? Point elsewhere.
  3. Elicit the real situation — what decision or system are we auditing?

[WAIT — do not advance until user responds]

  1. One question at a time: is this Extremistan or Mediocristan? What's the tail-survival design? What narrative am I constructing post-hoc?

[WAIT — do not advance until user responds]

  1. Close: name the specific tail-event preparation — not prediction — they've uncovered.

[WAIT — do not advance until user responds]

The Process

Step 1: Classify the domain (Extremistan vs Mediocristan)

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.

Step 2: Identify hidden Mediocristan assumptions in your Extremistan domain

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.

Step 3: Design for tail survival

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.

Step 4: Defend against the narrative fallacy

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.

Step 5: Distinguish black swans from grey swans

  • White swans: routine, well-modeled. Grey swans: rare but predictable (hurricane in a hurricane zone). Black swans: rare AND unpredictable.
  • Grey swan failure = planning failure. Black swan loss = design failure. The distinction matters.

Output: Black Swan Audit

# 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 · Fukushima Daiichi Tsunami, 2011 → 2026 lens: Concentration risk in the AI trade (2023–2026)

Pack: Black Swan Domains

DomainExtremistan evidenceTail-survival designCommon failure
Finance / tradingsingle crash day dominates decades of returns; 1987 was 20+ sigma under Gaussianleverage that survives correlations→1; no ruin-level position sizingVaR under Gaussian assumptions; "diversification" across risks that converge in crises
Venture / startupsone fund-returner outweighs the rest of the portfolio combinedmany small bets, convex upside; reserves for winners, not averagesmodeling outcomes with expected values; concentrating on one "sure thing"
Infrastructure / engineeringworst recorded flood / quake / tsunami dominates all damage totalsdesign margin above the full historical record; backups with no common-cause failuredesign basis anchored to recent-instrumental maximum (Fukushima's 5.7 m seawall)
Careers / creative worka handful of hits, roles, or books produce most lifetime payoffbarbell: stable base + repeated cheap shots at unbounded upsidebetting everything on one employer or project; reading a hot streak as a stable trend

Mediocristan (safe to use averages): human heights, daily caloric intake, commute times on normal days.

Contribute a pack for your domain — see the template at the repo root.

Applying It Well

  • Goal is tail-survival design, not prediction — you cannot predict the specific next black swan.
  • Most "diversified" portfolios are not: in crises, correlations jump toward 1. True diversification is across uncorrelated risks.
  • Mathematical sophistication does not protect against domain misclassification (LTCM lesson).
  • "This has worked for years" is the turkey's argument.

→ Primary sources: references/sources.md

Common Rationalizations

[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.

Fake moveReality
[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 narrativeHindsight 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 swanNot possible. Predict the category; design for tail-event survival.
[D] Treating "black swan" as an excuse for poor planningGrey swans get mislabeled as black swans by people who failed to plan.
[D] Diversification across correlated risksTrue diversification is across uncorrelated risks. In crises, correlations jump toward 1.
→ Add [O] entries here after each real use — paste the actual failure patternWhat went wrong and why

Red Flags

  • Risk model assumes Gaussian distribution in an Extremistan domain
  • "Has never happened" used as evidence of impossibility
  • Diversification claimed without analysis of correlation in crises
  • Confident prediction of when the next tail event will occur
  • Retrospective "obvious in hindsight" claims about past events
  • Mathematical sophistication treated as protection against domain misclassification

Verification

  • Domain classified (Extremistan / Mediocristan / mixed) with evidence
  • Hidden Mediocristan assumptions identified
  • Tail-survival design specified (bounded downside / optionality / redundancy / skin)
  • Past "black swans" in domain checked for narrative-fallacy framing
  • Grey swans distinguished from true black swans
  • Plan does not depend on predicting specific tail events

Part of deciqAI Knowledge Skills — 253 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. See it run → https://www.deciqai.com/s/black-swan · Built by deciqAI · github.com/deciqAI · Contributions welcome.

Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/black-swan.json

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.