MCPInstall

first principles thinking

This skill should be used when the user asks to "analyze from first principles", "第一性原理", "从根本分析", "从零开始思考", "think from scratch", "question this design", "这个设计合理吗", "is this the right approach", "为什么要这样做", "why are we doing it this way", "有没有更好的方案", "is there a better solution", "challenge assumptions", "挑战假设", or needs to evaluate architectural decisions, design choices, or problem-solving approaches without relying on analogies or conventions.

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

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/awesome-skills/first-principles-skill --skill first-principles-thinking
  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 first principles thinking 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.

First Principles Thinking

A systematic approach to decomposing complex problems into fundamental truths and reasoning up from there, avoiding the trap of reasoning by analogy.

When to Use This Skill

  • Evaluating whether an architecture or design is truly optimal
  • Questioning "best practices" that may not fit the current context
  • Breaking through when conventional solutions feel inadequate
  • Making foundational decisions that will have long-term impact
  • Challenging inherited assumptions in legacy systems
  • Designing new systems without cargo-culting existing patterns

Core Process

Phase 1: Identify the Problem's Essence

Strip away implementation details to find the core problem:

  1. State the problem clearly - What exactly needs to be solved?
  2. Separate symptoms from causes - Is this the real problem or a manifestation?
  3. Define success criteria - What would a perfect solution achieve?

Key Questions:

  • What is the fundamental job to be done here?
  • If this system didn't exist, what would users actually need?
  • What outcome matters, independent of how we get there?

Phase 2: Challenge All Assumptions

Identify and question every assumption:

  1. List explicit assumptions - What are we taking as given?
  2. Surface implicit assumptions - What conventions are we following without questioning?
  3. Test each assumption - Is this actually a constraint, or just how it's always been done?

Assumption Categories:

CategoryQuestion to Ask
Technical"Must we use this technology/pattern?"
Business"Is this requirement actually fixed?"
Resource"Are these constraints real or perceived?"
Historical"Why was this decision made originally?"

Red Flags (likely false assumptions):

  • "We've always done it this way"
  • "Industry standard says..."
  • "Everyone uses X for this"
  • "That's too simple to work"

Phase 3: Establish Ground Truths

Identify the irreducible facts:

  1. Physics/Math constraints - What cannot be violated?
  2. Business invariants - What must remain true for the business?
  3. User needs - What does the user fundamentally require?

Ground Truth Test:

  • Can this be further decomposed?
  • Is this provably true, not just commonly believed?
  • Would violating this definitely cause failure?

Phase 4: Reason Upward

Build solutions from ground truths:

  1. Start minimal - What's the simplest thing that satisfies ground truths?
  2. Add only what's necessary - Each addition must justify itself
  3. Challenge each layer - Does this layer earn its complexity?

Building Blocks Approach:

Ground Truth → Minimal Solution → Justified Additions → Final Design
     ↑              ↑                    ↑
  (proven)     (sufficient)        (each defended)

Phase 5: Validate the Reasoning

Ensure the solution is sound:

  1. Trace back to ground truths - Can every design decision be traced to a fundamental need?
  2. Identify weak links - Where does the reasoning rely on assumptions?
  3. Stress test - What would break this solution?

Output Format

When applying first principles thinking, structure the analysis as:

## First Principles Analysis: [Topic]

### 1. Problem Essence
**Core problem:** [One sentence]
**Success criteria:** [Measurable outcomes]

### 2. Assumptions Challenged
| Assumption | Challenge | Verdict |
|------------|-----------|---------|
| [Assumption] | [Why question it] | [Keep/Discard/Modify] |

### 3. Ground Truths
- [Irreducible fact 1]
- [Irreducible fact 2]
- [Irreducible fact 3]

### 4. Reasoning Chain
Ground Truth → [Step 1] → [Step 2] → Solution

### 5. Conclusion
**Recommended approach:** [Description]
**Key insight:** [What the first principles analysis revealed]
**Trade-offs acknowledged:** [What we're accepting]

Common Patterns

Pattern: The Complexity Trap

Symptom: Solution is more complex than the problem warrants

First Principles Check:

  1. Remove one component - does the system still solve the core problem?
  2. If yes, that component wasn't essential
  3. Repeat until removal breaks core functionality

Pattern: The Analogy Trap

Symptom: "Company X does it this way, so we should too"

First Principles Check:

  1. What problem was Company X actually solving?
  2. Is our problem identical in all relevant dimensions?
  3. What constraints did they have that we don't (and vice versa)?

Pattern: The Legacy Trap

Symptom: Maintaining compatibility with decisions that no longer serve us

First Principles Check:

  1. What was the original reason for this decision?
  2. Do those conditions still exist?
  3. What's the true cost of change vs. cost of maintaining?

Integration with Other Thinking Tools

First principles thinking works well with these complementary approaches:

ToolWhen to CombineHow
Trade-off AnalysisAfter identifying ground truthsEvaluate options against fundamentals
5-WhysWhen assumptions surfaceDig deeper to find root causes
Pre-mortemBefore finalizing solutionStress-test reasoning chain
Hypothesis TestingWhen ground truths are uncertainValidate assumptions empirically

Boundaries

Will:

  • Challenge assumptions systematically
  • Identify ground truths from first principles
  • Build reasoning chains from fundamentals
  • Reveal when conventional wisdom doesn't apply

Will Not:

  • Dismiss all existing solutions as wrong
  • Spend unlimited time on every decision (reserve for important choices)
  • Ignore practical constraints in favor of theoretical purity
  • Guarantee the "best" solution (reveals better reasoning, not perfect answers)

Quick Reference

The First Principles Checklist:

  • Problem stated in terms of outcomes, not solutions
  • All assumptions explicitly listed
  • Each assumption challenged and justified
  • Ground truths identified and verified
  • Solution built up from ground truths only
  • Every design decision traceable to a ground truth
  • Reasoning chain documented

Additional Resources

Reference Files

  • references/elon-musk-examples.md - Real-world examples from SpaceX and Tesla
  • references/software-examples.md - Software engineering applications

Example Files

  • examples/architecture-review.md - First principles analysis of a microservices decision

FAQ

What does the first principles thinking skill do?

This skill should be used when the user asks to "analyze from first principles", "第一性原理", "从根本分析", "从零开始思考", "think from scratch", "question this design", "这个设计合理吗", "is this the right approach", "为什么要这样做", "why are we doing it this way", "有没有更好的方案", "is there a better solution", "challenge assumptions", "挑战假设", or needs to evaluate architectural decisions, design choices, or problem-solving approaches without relying on analogies or conventions.

How do I install first principles thinking?

Run npx skills add https://github.com/awesome-skills/first-principles-skill --skill first-principles-thinking 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/first-principles-thinking/ (personal) or .claude/skills/first-principles-thinking/ (project).

Which AI agents can use first principles thinking?

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 first principles thinking 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 first principles thinking?

It is published by awesome-skills in awesome-skills/first-principles-skill. It has 64 recorded installs.

Popular other skills

View category →

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.

1.3M installs

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.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs