mcpField
M
mental-model-evaluator

mental-model-evaluator

github.com/mphinanceProductivity3288 installsUpdated 2d ago
Repository

About mental-model-evaluator

mental-model-evaluator is a decision-review skill for people assessing major architecture, feature, or trading plans. It applies established mental models and ends with a PASS, REVISE, or REJECT verdict.

Key features

  1. 01Reviews plans through at least three mental models
  2. 02Checks failure paths and core assumptions
  3. 03Examines downstream effects and defensibility
  4. 04Produces a structured Markdown report
  5. 05Concludes with a PASS, REVISE, or REJECT verdict

Use cases

  1. 01Stress-testing an architectural decision
  2. 02Reviewing a large feature proposal
  3. 03Evaluating a high-stakes trade plan

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mphinance/alpha-skills --skill mental-model-evaluator

After installing, type/mental-model-evaluatorin Claude Code to confirm it loaded.

Bundled filesREADME.md

Details

From the project README

Mental Model Evaluator

"Measure twice, cut once."

Before making major architectural decisions, writing a massive feature, or executing a high-stakes trade plan, this skill forces a pause and runs the proposed plan through established cognitive mental models.

Core Mental Models

  1. Inversion: "How could this plan completely fail?" Works backwards to identify guaranteed failure states and ensures the plan mitigates them.
  2. First Principles Thinking: Strips the plan down to fundamental truths. Are we building on an assumption, or an undeniable fact?
  3. Second-Order Effects: "And then what?" Evaluates the downstream consequences of the decision beyond the immediate payoff.
  4. Buffett's Moat Analysis: Does this feature/trade provide a sustainable, defensible advantage, or is it easily replicated noise?

Usage

When activated (Trigger phrases: "Evaluate this model", "Run the mental models", "Stress test this idea"):

  1. Read the user's proposed plan or idea.
  2. Output a structured markdown report that addresses the plan through the lens of at least 3 of the mental models above.
  3. Conclude with a final PASS, REVISE, or REJECT verdict.

Comments

Markdown supported