MCPInstall

mental-model-library

Use when a problem spans multiple disciplines or when single-domain thinking has produced stale analysis—applies Munger's latticework of mental models across physics, biology, and psychology.

Installs
45
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/joellewis/skill-library --skill mental-model-library
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads mental-model-library automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Overview

A "Mental Model" is a representation of how something works—a simplified map of reality. This skill provides a "Latticework of Mental Models" from major disciplines (Physics, Biology, Psychology, Math) to prevent "Man with a Hammer" syndrome—the tendency to treat every problem as a nail because you only have one tool.

Iron Law

NO COMPLEX ANALYSIS WITHOUT CHECKING FOR APPLICABLE MENTAL MODELS

Relying on intuition alone ensures that you will fall victim to predictable cognitive biases. Systematic model application is the only defense against human misjudgment.

State Machine

digraph mental_model_flow {
    "Problem Identified" [shape=doublecircle];
    "Invert: Define Failure" [shape=box];
    "Filter: Identify Core Discipline" [shape=box];
    "Apply: Select 2-3 Models" [shape=box];
    "Gate: Bias Check" [shape=diamond];
    "Synthesize: Find Intersections" [shape=box];
    "Decision/Insight" [shape=doublecircle];

    "Problem Identified" -> "Invert: Define Failure";
    "Invert: Define Failure" -> "Filter: Identify Core Discipline";
    "Filter: Identify Core Discipline" -> "Apply: Select 2-3 Models";
    "Apply: Select 2-3 Models" -> "Gate: Bias Check";
    "Gate: Bias Check" -> "Synthesize: Find Intersections" [label="clean"];
    "Gate: Bias Check" -> "Filter: Identify Core Discipline" [label="bias found"];
    "Synthesize: Find Intersections" -> "Decision/Insight";
}

When to Use This Skill

  • When a problem seems "stuck" or repetitive.
  • Before making an irreversible decision (e.g., product pivot, major hiring, market entry).
  • When analyzing why a competitor is succeeding or why a project failed.
  • During a "Pre-Mortem" to identify hidden risks.

When NOT to Use This Skill

  • For routine, low-stakes operational tasks where speed is more valuable than depth.
  • When the goal is creative expression rather than objective analysis.

Core Process

Step 1: Invert, Always Invert

Instead of asking "How do I succeed?", ask "How could this fail spectacularly?" Define the conditions for failure and work backward to avoid them (Source: Munger).

Step 2: Traverse the Latticework

Apply models from at least three different disciplines to the problem:

  • Physics: Is there Entropy (disorder) increasing? Is there a Leverage point?
  • Biology: Are Incentives driving behavior? Is there a Red Queen Effect (running to stay in place)?
  • Chemistry: Is there enough Activation Energy to start this change? (Source: Parrish).

Step 3: Identify the Lollapalooza

Look for points where multiple biases or models act in the same direction. When 3+ models align, the outcome will be non-linear and massive (Source: Munger).

Step 4: Run the Misjudgment Checklist

Audit your conclusion against the 25 Psychological Tendencies (e.g., Social Proof, Reciprocation, Availability Bias) to ensure you aren't fooling yourself (Source: Munger).

The Model Registry (High-Leverage Only)

DisciplineModelPrinciple (Source: Parrish/Munger/Bevelin)
ThinkingInversionTurn the problem upside down to see what to avoid.
ThinkingFirst PrinciplesStrip a system down to its fundamental truths and build up.
PhysicsEntropyDisorder increases naturally; order requires energy.
PhysicsLeverageSmall inputs at the right point produce massive outputs.
BiologyEvolutionIndividuals and organizations that don't adapt go extinct.
BiologyIncentives"Show me the incentive, and I'll show you the outcome."
SystemsFeedback LoopsOutputs that circle back to inputs (vicious or virtuous).
PsychologySocial ProofWe look to others to determine correct behavior.
PsychologyLoss AversionThe pain of losing is 2x stronger than the joy of winning.

Cross-Skill Invocations

  • REQUIRED SUB-SKILL: getting-started — To route the problem to the correct family before applying models.
  • RECOMMENDED SUB-SKILL: decision-frameworks — For formalizing the output of the mental model analysis.
  • RECOMMENDED SUB-SKILL: devils-advocate — To use Inversion as a tool for stress-testing.

Rationalization Table

ThoughtReality
"I don't have time to go through 100 models."You only need the 5-10 "big ideas" to catch 90% of errors.
"This is a business problem, I don't need Physics."Economic systems are subject to the same laws of scale and limits.
"I already know why this is happening."Your "knowledge" is often a story masking a cognitive bias.
"Mental models are just fancy names for common sense."Common sense is not common; models make it systematic and repeatable.

Red Flags

  • "Man with a Hammer" → You are forcing the problem to fit your favorite model (e.g., only seeing incentives).
  • "Confirmation Bias" → You are only looking for models that support your current plan.
  • "Ignoring Scale" → You assume a model that works at small scale (Start-up) works at large scale (Enterprise).

Diagnostic Checklist

  • Have I Inverted the problem to identify "how to fail"?
  • Have I applied models from at least three different disciplines?
  • Have I checked for Lollapalooza effects (confluence of forces)?
  • Have I audited for the Social Proof or Incentive biases?
  • Am I working within my Circle of Competence?

Sources

  • Munger, Charles. Poor Charlie's Almanack, Talk Eleven (Psychology of Human Misjudgment).
  • Parrish, Shane. The Great Mental Models, Vol 1 (General Thinking), Vol 2 (Science).
  • Bevelin, Peter. Seeking Wisdom, Ch. 2 (Psychology), Ch. 3 (Physics/Math).

FAQ

What does the mental-model-library skill do?

Use when a problem spans multiple disciplines or when single-domain thinking has produced stale analysis—applies Munger's latticework of mental models across physics, biology, and psychology.

How do I install mental-model-library?

Run npx skills add https://github.com/joellewis/skill-library --skill mental-model-library in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/mental-model-library/ (personal) or .claude/skills/mental-model-library/ (project).

Which AI agents can use mental-model-library?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is mental-model-library safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains mental-model-library?

It is published by joellewis in joellewis/skill-library. It has 45 recorded installs.

More from joellewis/skill-library

View all →

fiction-architect

joellewis/skill-library

Open the skill to read its SKILL.md instructions.

55 installs

dialogue-craft

joellewis/skill-library

Open the skill to read its SKILL.md instructions.

53 installs

world-building-logic

joellewis/skill-library

Open the skill to read its SKILL.md instructions.

53 installs

character-vulnerability

joellewis/skill-library

Open the skill to read its SKILL.md instructions.

Security47 installs

one-pager

joellewis/skill-library

Open the skill to read its SKILL.md instructions.

47 installs

problem-framing

joellewis/skill-library

Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.

47 installs

Popular education & science skills

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

scaffold-exercises

mattpocock/skills

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

Education & Science488.2K installs

paper-context-resolver

lllllllama/rigorpilot-skills

Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.

Education & Science478.3K installs

caveman-learn

juliusbrussee/caveman

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Education & Science107.9K installs

gsap-plugins

greensock/gsap-skills

Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.