
decision-frameworks
Use when choosing between mutually exclusive strategic paths or building a repeatable decision process—constructs Decision Matrices with probability estimates and runs Pre-Mortems.
- Installs
- 46
- 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 decision-frameworks- 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 decision-frameworks 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
Decision frameworks provide the structural rigor to make high-quality choices under uncertainty. This skill transforms decision-making from an emotional "gut feel" into a probabilistic process by decoupling outcomes from process, identifying cognitive biases, and utilizing a latticework of mental models to uncover second-order consequences.
Guiding Principles
Principle 1: Decisions are Bets (Source: Duke, Thinking in Bets)
Every decision is a bet on a specific future. Shift from binary "Right/Wrong" thinking to probabilistic "Confidence" thinking. Acknowledging uncertainty (e.g., "I am 70% confident") improves decision quality and reduces the sting of bad outcomes.
Principle 2: Anti-Resulting (Source: Duke, Thinking in Bets)
Do not judge a decision solely by its outcome. A "good" result can come from a "bad" process due to luck. Evaluate the process used at the time of the decision, not the final result.
Principle 3: Latticework of Models (Source: Munger, Poor Charlie's Almanack)
You cannot make wise decisions with a single mental model. You must have a "latticework" of models from multiple disciplines (math, physics, biology, psychology) to avoid the "Man with a Hammer" syndrome.
Principle 4: Circle of Competence (Source: Parrish, Great Mental Models v1)
Know the boundaries of your knowledge. Decisions made outside your circle of competence have a much higher risk of failure. If you must decide outside your circle, seek a partner with the missing expertise.
Principle 5: Pragmatic Truth (Source: Sivers, Useful Not True)
When faced with multiple interpretations of a situation, choose the one that is most useful for making progress, even if it is not "100% true." Belief is a tool for action.
When to Use This Skill
- When a decision involves significant "downside" risk or high uncertainty.
- When choosing between mutually exclusive strategic paths.
- When building a "Decision Journal" for organizational learning.
- When an individual or team is stuck in "Analysis Paralysis."
When NOT to Use This Skill
- For low-stakes, reversible decisions (e.g., "Type 2" decisions). (Source: Bezos, Amazon Letter)
- When speed is the primary requirement and the cost of being wrong is negligible.
Core Process
Step 1: Frame the Decision
Clearly state the choice being made and the desired outcome.
- The Happiness Test: Will this decision matter in 10 minutes? 10 months? 10 years? Use the result to determine how much time to spend on the decision. (Source: Duke, How to Decide)
- First Principles: Strip away the analogies and conventional wisdom. What are the fundamental truths of this situation? (Source: Parrish, v1)
Step 2: Build the Decision Matrix
Map the possibilities and probabilities. (Source: Duke, How to Decide)
- Options: List all possible paths (including "Do Nothing").
- Outcomes: For each path, list the possible results (Best, Worst, Average).
- Probabilities: Assign a percentage chance to each outcome.
Step 3: Apply Mental Model Stress-Tests
Use the latticework to uncover hidden flaws. (Source: Munger, Parrish)
- Inversion: What would cause this decision to be a disaster? How do we avoid that?
- Second-Order Thinking: Ask "And then what?" for the preferred outcome. What are the long-term consequences?
- Occam's Razor: If there are two competing solutions, is the simpler one more likely to be correct? (Source: FS Blog)
Step 4: Perform a Pre-Mortem
Imagine the decision has failed 12 months from now. (Source: Duke, How to Decide)
- Identify the Cause: Why did it fail? (e.g., market shift, execution gap, technical debt).
- Mitigate: Adjust the current plan to prevent those identified failure modes.
Step 5: Document in the Decision Journal
Record the reasoning at the time to prevent hindsight bias. (Source: Duke, Thinking in Bets)
- The Context: What did we know at the time?
- The Reasoning: Why did we choose this path?
- The Confidence: What was our percentage confidence in the result?
Frameworks & Models
The Decision Matrix (Source: Duke, How to Decide)
A structured table mapping:
- Option A vs. Option B.
- Probabilities of Success/Failure.
- Expected Value (Value * Probability).
Hanlon's Razor (Source: FS Blog)
"Never attribute to malice that which is adequately explained by stupidity (or incompetence)." Use this to prevent emotional bias in interpersonal or competitive decisions.
Map vs. Territory (Source: Parrish, Great Mental Models v1)
The model (the map) is not the reality (the territory). Always check if the "map" you are using for a decision matches the actual "territory" on the ground.
Cross-Skill Invocations
- REQUIRED SUB-SKILL:
devils-advocate— To stress-test the preferred option in the matrix. - RECOMMENDED SUB-SKILL:
assumption-audit— To validate the probabilities assigned in Step 2. - RECOMMENDED SUB-SKILL:
mental-model-library— For a broader set of models beyond the core three.
Common Mistakes
- Resulting: Judging a decision based on its outcome rather than the process. (Source: Duke, Ch. 1)
- Analysis Paralysis: Spending more time on a decision than the "Happiness Test" justifies. (Source: Duke, Ch. 5)
- Overconfidence: Stating 100% certainty in an uncertain future. (Source: Duke, Ch. 2)
- Hindsight Bias: Believing you "knew it all along" after the result is known. (Source: Duke, Ch. 6)
Diagnostic Checklist
- Have we decoupled the outcome from the decision process?
- Have we assigned probabilistic confidence scores (e.g., 60%, 80%) to our claims?
- Have we performed an "Inversion" or "Pre-Mortem" to identify failure paths?
- Is this decision within our "Circle of Competence"?
- Have we considered second-order consequences ("And then what?")?
Sources
- Duke, Thinking in Bets, Ch. 1, 2, 6 — Resulting, Confidence, Decision Journal.
- Duke, How to Decide, Ch. 3, 4, 5 — Decision Matrix, Pre-Mortem, Happiness Test.
- Parrish, Great Mental Models v1, Ch. 1, 2, 4 — First Principles, Circle of Competence, Second-Order Thinking.
- Munger, Poor Charlie's Almanack, Ch. 2 — Latticework, Inversion.
- Sivers, Useful Not True — Pragmatic belief as a decision tool.
FAQ
What does the decision-frameworks skill do?
Use when choosing between mutually exclusive strategic paths or building a repeatable decision process—constructs Decision Matrices with probability estimates and runs Pre-Mortems.
How do I install decision-frameworks?
Run npx skills add https://github.com/joellewis/skill-library --skill decision-frameworks 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/decision-frameworks/ (personal) or .claude/skills/decision-frameworks/ (project).
Which AI agents can use decision-frameworks?
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 decision-frameworks 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 decision-frameworks?
It is published by joellewis in joellewis/skill-library. It has 46 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 other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.