
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads mental-model-library automatically when relevant.
- 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)
| Discipline | Model | Principle (Source: Parrish/Munger/Bevelin) |
|---|---|---|
| Thinking | Inversion | Turn the problem upside down to see what to avoid. |
| Thinking | First Principles | Strip a system down to its fundamental truths and build up. |
| Physics | Entropy | Disorder increases naturally; order requires energy. |
| Physics | Leverage | Small inputs at the right point produce massive outputs. |
| Biology | Evolution | Individuals and organizations that don't adapt go extinct. |
| Biology | Incentives | "Show me the incentive, and I'll show you the outcome." |
| Systems | Feedback Loops | Outputs that circle back to inputs (vicious or virtuous). |
| Psychology | Social Proof | We look to others to determine correct behavior. |
| Psychology | Loss Aversion | The 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
| Thought | Reality |
|---|---|
| "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
fiction-architect
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
world-building-logic
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
character-vulnerability
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
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.
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
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.
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.
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.
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.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.