Black Swans logo

Black Swans

Community
fatihguner
black-swans

Applies Taleb's Black Swan theory to assess and mitigate exposure to rare, high-impact unpredictable events. Distinguishes between Mediocristan and Extremistan domains, designs barbell strategies, builds antifragility, and audits business vulnerabilities including supply chain concentration, customer dependency, and regulatory risk. Use when stress-testing a business model, evaluating tail risks, designing resilience architecture, or building robust strategies that survive shocks rather than attempting to predict them.

Overview

Publisherfatihguner
Repositoryforeman
Skill nameblack-swans
Stars
63
Forks
10
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by fatihguner on GitHub. Read the source before you install it.

Installation

Install the Black Swans AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/fatihguner/foreman/tree/main/plugins/foreman/skills/black-swans
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/fatihguner/foreman.git /tmp/foreman
mkdir -p .claude/skills
cp -r /tmp/foreman/plugins/foreman/skills/black-swans .claude/skills/black-swans
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Black Swans in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Black Swans on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Black Swans is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Read runtime and advisory rules before applying this skill. Other Foreman layers and the catalog are in ../../content/, relative to this SKILL.md.

Black Swan Theory

On September 15, 2008, Lehman Brothers filed for the largest bankruptcy in American history. Within weeks, the global financial system stood at the brink of collapse. Virtually no mainstream economist had predicted the crisis. The models were elegant, the data was abundant, and the conclusions were catastrophically wrong. Nassim Nicholas Taleb had a name for this kind of event -- a Black Swan -- and his 2007 book of the same title had warned, with uncomfortable precision, that the financial system was a powder keg. The concept has since become indispensable vocabulary for anyone who takes risk seriously.

A Black Swan is an event that satisfies three criteria: it is an outlier beyond the realm of regular expectations, it carries extreme impact, and human nature compels us to fabricate explanations for it after the fact, making it seem predictable in retrospect. The theory does not concern itself with predicting these events -- that is the point. It concerns itself with acknowledging their inevitability and structuring decisions accordingly.


The Framework

Taleb's argument rests on a distinction between two domains of uncertainty, which he labels Mediocristan and Extremistan.

Mediocristan vs. Extremistan

DomainCharacteristicsExamples
MediocristanOutcomes cluster around the mean; no single observation can dramatically alter the aggregateHuman height, calorie consumption, car accident rates
ExtremistanA single observation can disproportionately dominate the total; winner-take-all dynamics prevailBook sales, wealth distribution, startup valuations, pandemic deaths

Most business decisions operate in Extremistan, yet most business tools assume Mediocristan. This mismatch is the source of strategic catastrophe.

The Three Properties of a Black Swan

  1. Rarity -- The event lies outside ordinary experience. No amount of historical data would have led a reasonable observer to anticipate it.
  2. Extreme Impact -- When it arrives, it reshapes the landscape. Market structures, competitive positions, and entire industries can be created or destroyed.
  3. Retrospective Predictability -- After the event, analysts construct narratives that make it appear inevitable. This "narrative fallacy" breeds dangerous overconfidence.

The Narrative Fallacy and Confirmation Bias

Humans are pattern-seeking creatures. Taleb argues that we systematically overfit stories to data, mistaking correlation for causation and randomness for signal. Entrepreneurs are especially vulnerable: the hero narratives of startup culture encourage the belief that outcomes are earned rather than partly determined by chance. Acknowledging the role of luck is not defeatism -- it is the foundation of robust strategy.

Building Robustness (and Antifragility)

Taleb's prescription is not to predict Black Swans but to build systems that survive them -- or, better still, benefit from them:

  • Barbell Strategy: Concentrate resources in extremely safe assets on one end and small, high-upside bets on the other. Avoid the middle, where moderate risk produces moderate returns but maximum vulnerability to Black Swans.
  • Optionality: Structure decisions so that upside is uncapped while downside is limited. Startups that can pivot cheaply have more optionality than those locked into rigid capital commitments.
  • Redundancy over Efficiency: Systems optimized purely for efficiency are fragile. Maintaining slack -- cash reserves, diversified suppliers, backup capabilities -- creates resilience.
  • Via Negativa: Sometimes the most powerful strategy is subtraction. Eliminate exposures to catastrophic risk rather than trying to add predictive capability.

Prompts

Prompt 1 -- Black Swan Exposure Audit:

Analyze my business for Black Swan vulnerability. My company is [describe company, sector, stage, key dependencies]. Identify our top 5 exposures to rare, high-impact events -- consider supply chain, technology shifts, regulatory changes, customer concentration, and financial structure. For each exposure, rate the potential impact (existential / severe / moderate) and our current resilience (fragile / robust / antifragile). Present results in a table.

Prompt 2 -- Barbell Strategy Design:

Help me design a barbell strategy for [company/product/investment portfolio]. On the safe end, what should I protect absolutely? On the speculative end, what small bets with asymmetric upside should I place? What middle-ground positions should I reduce or eliminate? Structure the output as a three-column framework: Safe (80-90% of resources), Eliminate (the vulnerable middle), and Speculative (10-20% of resources).

Prompt 3 -- Post-Mortem Narrative Fallacy Check:

I recently experienced [describe event -- a major win, loss, or surprise]. Walk me through a narrative fallacy analysis. What story am I likely telling myself about why this happened? What alternative explanations exist that I might be ignoring? What role did randomness, timing, or external forces play? Help me separate genuine causal factors from retrospective storytelling.

Prompt 4 -- Antifragility Assessment:

Evaluate whether my business model is fragile, robust, or antifragile using Taleb's framework. My company is [describe]. For each major dimension -- revenue model, team structure, technology stack, customer base, funding structure -- classify the current state and recommend specific changes to move toward antifragility. What stressors could actually make us stronger?


Use Cases

SaaS Startup with Single-Cloud Dependency A Series A SaaS company runs its entire infrastructure on a single cloud provider with no multi-cloud contingency. The founder applies the Black Swan exposure audit and discovers that a provider outage, pricing change, or policy shift represents an existential risk. The barbell strategy suggests maintaining 85% of workloads on the primary provider (cost-efficient and familiar) while investing 15% of engineering capacity into abstraction layers and secondary provider readiness. The company does not need to run multi-cloud today -- it needs the option to migrate within weeks rather than months.

Consumer Hardware Startup Facing Supply Chain Concentration A growth-stage hardware company sources a critical component from a single factory in one region. COVID-19 demonstrated that geographic concentration in manufacturing is a textbook Extremistan exposure. Applying Taleb's redundancy principle, the founder diversifies to three suppliers across two continents, accepting a 12% cost increase in exchange for eliminating single-point-of-failure risk. The cost is insurance, not waste.

Venture-Backed Marketplace Dependent on Regulatory Goodwill A marketplace startup operating in a lightly regulated space applies the exposure audit and recognizes that a single regulatory change could eliminate its business model entirely. Rather than lobbying alone, the founder builds optionality: a secondary revenue model that functions under stricter regulation, and contractual structures that limit liability exposure. The Black Swan lens reframes regulatory risk from "unlikely" to "unknown timing."


Anti-Patterns

  1. Treating Black Swan theory as a license for paranoia. The framework is not about fearing everything -- it is about identifying asymmetric exposures and restructuring them. Founders who become paralyzed by tail-risk analysis accomplish nothing. The goal is robustness, not anxiety.

  2. Claiming every negative surprise is a Black Swan. A competitor launching a similar product is not a Black Swan -- it is a foreseeable competitive event. Losing a key client is painful but predictable. Reserve the label for events that genuinely lie outside the boundary of reasonable expectation. Overuse dilutes the concept into meaninglessness.

  3. Confusing fragility reduction with prediction. The entire point of the framework is that Black Swans cannot be predicted. Founders who respond by hiring consultants to "predict Black Swans" have missed Taleb's argument entirely. The correct response is structural: build systems that survive shocks, not crystal balls that fail to foresee them.

  4. Ignoring positive Black Swans. Taleb explicitly discusses positive Black Swans -- unexpected events with massive upside. Entrepreneurs who focus exclusively on downside risk miss the strategic imperative to position for serendipity. Maintaining optionality, staying visible in networks, and placing small speculative bets are strategies that harvest positive Black Swans.

  5. Over-optimizing for efficiency at the expense of redundancy. The lean startup ethos prizes efficiency, and rightly so at the earliest stages. But as companies grow, the relentless elimination of slack creates brittleness. The company with zero cash reserves, one key engineer, and a single revenue channel is not lean -- it is fragile.


By Stage

StageFocusKey Difference
ValidationIdentify existential assumptionsAt this stage, the entire venture is one large bet. The Black Swan lens helps founders distinguish between assumptions they can test and exposures they cannot control. Focus on limiting downside through cheap experiments rather than heavy capital commitment.
GrowthStress-test dependenciesRevenue is flowing but concentration risk is building. Audit customer concentration, supplier dependencies, and team key-person risk. Begin building redundancy into systems that were expedient during validation.
ScaleInstitutional resilience architectureAt scale, the stakes are highest and the organization is most prone to complacency. Implement formal risk committees, maintain meaningful cash reserves, and run regular Black Swan tabletop exercises. The goal shifts from personal awareness to organizational culture.

Output Template

markdown
# Black Swan Exposure Assessment

**Company:** [Name]
**Stage:** [Current stage]
**Date:** [Date]

## Exposure Map

| Exposure | Domain (Mediocristan/Extremistan) | Impact if Realized | Current Resilience | Priority |
|----------|----------------------------------|--------------------|--------------------|----------|
| [Exposure 1] | [Domain] | [Existential/Severe/Moderate] | [Fragile/Robust/Antifragile] | [Critical/High/Medium] |
| [Exposure 2] | [Domain] | [Impact] | [Resilience] | [Priority] |
| [Exposure 3] | [Domain] | [Impact] | [Resilience] | [Priority] |

## Barbell Strategy

### Safe Side (80-90% of resources)
- [What to protect absolutely]

### Eliminate (Vulnerable middle)
- [Positions to reduce or exit]

### Speculative Side (10-20% of resources)
- [Small, high-upside bets]

## Immediate Actions
1. [Highest-priority resilience action]
2. [Second priority]
3. [Third priority]

## Review Cadence
- Quarterly exposure reassessment
- Annual barbell rebalancing

Related Skills

  • Scenario Planning -- Where Black Swan theory addresses the unpredictable, scenario planning builds structured responses to plausible futures; together they cover both the foreseeable and the unforeseeable.
  • Business Model Canvas -- Mapping the entire business model makes hidden dependencies visible, which is a precondition for effective Black Swan exposure auditing.
  • Systems Thinking -- Reveals the interconnected feedback loops through which a single shock can cascade across an entire business, amplifying Black Swan impact in non-obvious ways.
  • VUCA Framework -- Provides the vocabulary and leadership approach for operating in volatile, uncertain environments where Black Swan events are structurally inevitable.
  • Thinking, Fast and Slow -- Kahneman's work on cognitive biases explains why humans systematically underestimate tail risks, making Taleb's prescriptions for structural robustness essential.
  • Decision Making Under Pressure -- Provides the leadership practices for making sound decisions when a Black Swan event actually materializes and time is compressed.

Frequently asked questions

What does the Black Swans AI skill do?

Applies Taleb's Black Swan theory to assess and mitigate exposure to rare, high-impact unpredictable events. Distinguishes between Mediocristan and Extremistan domains, designs barbell strategies, builds antifragility, and audits business vulnerabilities including supply chain concentration, customer dependency, and regulatory risk. Use when stress-testing a business model, evaluating tail risks, designing resilience architecture, or building robust strategies that survive shocks rather than attempting to predict them.

Why use Black Swans on TypingMind?

Because you install it once and use it with any model. Black Swans is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Black Swans in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/fatihguner/foreman/tree/main/plugins/foreman/skills/black-swans. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Black Swans?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Black Swans?

As many as you like. As long as a model supports skills, you can use Black Swans with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Black Swans AI skill free?

Yes. It is published on GitHub by fatihguner under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇