← Back to Skills Marketplace
ivangdavila

First Principles Thinking

by Iván · GitHub ↗ · v1.0.0
linuxdarwinwin32 ✓ Security Clean
902
Downloads
1
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install first-principles-thinking
Description
Break problems to fundamentals, rebuild from truth, eliminate hidden assumptions.
README (SKILL.md)

When to Use

User faces complex problem where conventional solutions fail. Existing approaches seem inadequate. Need to challenge assumptions or innovate fundamentally. Stuck in "that's how it's always done" thinking.

Quick Reference

Topic File
Decomposition techniques decomposition.md
Common assumption traps assumptions.md

Core Rules

1. The Three-Step Protocol

Step 1 — Decompose: Break the problem into fundamental components.

  • What are the absolute physical/logical constraints?
  • What is actually true vs what we assume is true?
  • Strip away all conventions, traditions, analogies.

Step 2 — Verify: Challenge each component.

  • "Why do we believe this?" — trace to origin
  • "Is this a law of nature or a human convention?"
  • "What evidence supports this being fundamental?"

Step 3 — Rebuild: Construct solution from verified fundamentals only.

  • Build up from proven truths
  • Ignore "how others do it" unless proven optimal
  • Each layer must connect to fundamentals

2. Identify Hidden Assumptions

Before solving, expose what's assumed:

Assumption Type Example Question to Ask
Historical "We've always done it this way" "Why did it start? Does that reason still apply?"
Authority "Experts say X" "What's the underlying evidence?"
Analogical "It's like Y, so..." "Are the underlying mechanics actually similar?"
Social "Everyone does it" "Does popularity equal optimality?"
Resource "We can't afford to..." "What if resources weren't the constraint?"

3. The Constraint Test

For each constraint ask:

  1. Is this a law of physics? → Respect it
  2. Is this a logical necessity? → Respect it
  3. Is this a regulation/rule? → Can be changed (with effort)
  4. Is this a convention? → Can be ignored
  5. Is this an assumption? → Must be verified

4. When NOT to Use First Principles

First principles is expensive. Use analogical reasoning when:

  • Problem is well-understood with proven solutions
  • Time pressure doesn't allow deep analysis
  • Marginal improvement is sufficient
  • Domain is stable with little innovation potential

Rule: First principles for novel problems or when conventional fails. Analogy for routine optimization.

5. Socratic Decomposition

Use recursive "why" questioning:

Problem: "Electric cars are too expensive"

Why expensive? → Batteries cost a lot
Why batteries expensive? → Materials + manufacturing
Why materials expensive? → Cobalt, lithium pricing
Why those materials? → Current chemistry requires them
Is that fundamental? → No, chemistry can change

Fundamental: Need energy storage. Not: Need cobalt batteries.

Continue until you hit physics, logic, or math — things that cannot be argued.

6. The Blank Slate Test

Imagine the problem exists but NO solutions have been tried:

  • "If we were starting from scratch today, with current knowledge and technology, how would we solve this?"
  • This bypasses legacy thinking and sunk cost fallacy.

7. Output Format

When applying first principles, structure response as:

## Problem Statement
[Clear definition of what we're solving]

## Assumed Constraints (to verify)
- Constraint A — [source: historical/authority/etc.]
- Constraint B — [source]

## Fundamental Truths
- Truth 1 (physics/logic/math based)
- Truth 2

## Decomposition
[Break down into components]

## Rebuilt Solution
[Solution constructed from fundamentals only]

## Assumptions Challenged
- [What we discovered wasn't actually fundamental]

Common Traps

  • Stopping too early → "Materials are expensive" isn't fundamental; "atoms have mass" is. Keep going.
  • Confusing difficulty with impossibility → "It's hard" ≠ "It's against physics"
  • Rejecting all analogy → Analogies are useful heuristics; first principles is for when they fail
  • Analysis paralysis → Set time limits; perfect decomposition isn't the goal, better thinking is
  • Ignoring implementation → A fundamental solution that can't be built is useless; constraints matter
  • Lone wolf thinking → First principles benefits from multiple perspectives challenging assumptions

Domain Applications

Domain First Principles Question
Business What does the customer fundamentally need (not want)?
Engineering What do physics and materials actually allow?
Product What job is being done at the most basic level?
Cost What are the raw inputs and minimum required labor?
Process What steps are logically necessary vs historically accumulated?

Security & Privacy

Data that stays local:

  • All reasoning happens in conversation context
  • No data stored or transmitted

This skill does NOT:

  • Store any information between sessions
  • Make network requests
  • Access external files

Related Skills

Install with clawhub install \x3Cslug> if user confirms:

  • decide — auto-learn decision patterns
  • business — validate and refine strategy
  • ceo — executive decision-making
  • startup — build from zero to PMF

Feedback

  • If useful: clawhub star first-principles-thinking
  • Stay updated: clawhub sync
Usage Guidance
This is a low-risk, instruction-only skill that simply guides problem decomposition. Before installing: (1) Note the skill comes from an unknown source — review the content and ensure you trust the owner. (2) It may prompt you for contextual details during use — avoid entering secrets, credentials, or private documents into the conversation. (3) The SKILL suggests installing related skills (via clawhub); those other skills may have different requirements — review them individually before installing. (4) Try it on non-sensitive example problems first to confirm behavior matches expectations.
Capability Analysis
Type: OpenClaw Skill Name: first-principles-thinking Version: 1.0.0 The OpenClaw skill bundle 'first-principles-thinking' is benign. It consists entirely of markdown documentation and metadata, with no executable code. The `SKILL.md` explicitly declares that the skill does not require any external binaries (`'bins':[]`), does not store or transmit data, make network requests, or access external files. All content is instructional, guiding the user and agent on a problem-solving methodology, with no evidence of prompt injection attempts, data exfiltration, malicious execution, or persistence mechanisms.
Capability Assessment
Purpose & Capability
Name/description (first-principles reasoning) align with the contents: stepwise decomposition, assumption detection, and rebuild guidance. No unrelated binaries, env vars, or config paths are requested.
Instruction Scope
SKILL.md contains only conversational/analytical instructions (how to ask 'why', decompose, format output). It does not instruct the agent to read files, access system state, call external endpoints, or exfiltrate data. It will naturally ask users for context, which is expected for a reasoning skill.
Install Mechanism
No install spec or code — this is instruction-only. Nothing will be downloaded or written to disk by the skill itself.
Credentials
No environment variables, credentials, or config paths are required. The skill's Security & Privacy claims (no storage, no network/file access) match the instruction-only form.
Persistence & Privilege
always is false and there is no persistence or self-modifying install behavior. The skill can be invoked by the agent (default), which is appropriate for a conversational tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install first-principles-thinking
  3. After installation, invoke the skill by name or use /first-principles-thinking
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with three-step protocol, assumption detection, and domain applications.
Metadata
Slug first-principles-thinking
Version 1.0.0
License
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is First Principles Thinking?

Break problems to fundamentals, rebuild from truth, eliminate hidden assumptions. It is an AI Agent Skill for Claude Code / OpenClaw, with 902 downloads so far.

How do I install First Principles Thinking?

Run "/install first-principles-thinking" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is First Principles Thinking free?

Yes, First Principles Thinking is completely free (open-source). You can download, install and use it at no cost.

Which platforms does First Principles Thinking support?

First Principles Thinking is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).

Who created First Principles Thinking?

It is built and maintained by Iván (@ivangdavila); the current version is v1.0.0.

💬 Comments