first-principles-decomposer

Break any problem down to fundamental truths, then rebuild solutions from atoms up. Use when user says "firstp", "first principles", "from scratch", "what are we assuming", "break this down", "atomic", "fundamental truth", "physics thinking", "Elon method", "bedrock", "ground up", "core problem", "strip away", or challenges assumptions about how things are done.

3,891 stars

Best use case

first-principles-decomposer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Break any problem down to fundamental truths, then rebuild solutions from atoms up. Use when user says "firstp", "first principles", "from scratch", "what are we assuming", "break this down", "atomic", "fundamental truth", "physics thinking", "Elon method", "bedrock", "ground up", "core problem", "strip away", or challenges assumptions about how things are done.

Teams using first-principles-decomposer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/first-principles-decomposer/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/artyomx33/first-principles-decomposer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/first-principles-decomposer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How first-principles-decomposer Compares

Feature / Agentfirst-principles-decomposerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Break any problem down to fundamental truths, then rebuild solutions from atoms up. Use when user says "firstp", "first principles", "from scratch", "what are we assuming", "break this down", "atomic", "fundamental truth", "physics thinking", "Elon method", "bedrock", "ground up", "core problem", "strip away", or challenges assumptions about how things are done.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# First Principles Decomposer

## When To Use
- Designing new products or features
- Feeling stuck on a complex problem
- Existing solutions seem overcomplicated
- Need to challenge assumptions
- Starting any new project or initiative

## The Process

### Phase 1: Identify Assumptions
Ask: "What am I assuming to be true that might not be?"
List every assumption embedded in the current approach.

### Phase 2: Break to Atoms
For each assumption, ask: "What is the most fundamental truth here?"
Keep asking "why?" until you hit bedrock facts.

### Phase 3: Rebuild From Truth
Starting ONLY from verified fundamentals, ask:
"What's the simplest solution that addresses the core need?"

## Interactive Flow

When user invokes this skill:

1. **Clarify the problem** (1-2 questions max)
2. **Surface assumptions** - list what's being taken for granted
3. **Decompose to fundamentals** - show the atomic truths
4. **Rebuild solution** - construct from ground up
5. **Compare** - show how this differs from conventional approach

## Output Format

```
PROBLEM: [stated problem]

ASSUMPTIONS IDENTIFIED:
1. [assumption] → Challenge: [why this might be wrong]
2. [assumption] → Challenge: [why this might be wrong]

FUNDAMENTAL TRUTHS:
• [bedrock fact 1]
• [bedrock fact 2]
• [bedrock fact 3]

REBUILT SOLUTION:
[New approach built only from fundamentals]

VS CONVENTIONAL:
[How this differs from the obvious approach]
```

## Example Triggers
- "Break down our parent communication problem from first principles"
- "I want to rethink how we do [X] from the ground up"
- "What are we assuming about [problem] that might be wrong?"

## Integration

This skill compounds with:
- **inversion-strategist** - After rebuilding from fundamentals, invert to find what would guarantee failure of the new approach
- **second-order-consequences** - Project downstream effects of implementing the rebuilt solution
- **pre-mortem-analyst** - Stress-test the rebuilt solution by imagining its failure
- **six-thinking-hats** - Apply all six perspectives to validate each fundamental truth identified

## Skill Metadata
**Created**: 2026-01-06
**Last Updated**: 2026-01-06
**Author**: Artem
**Version**: 1.0

---
See references/framework.md for detailed methodology
See references/examples.md for Artem-specific examples
See references/integrated-frameworks.md for Stanford Design Thinking + MIT Systems Engineering combo

Related Skills

task-decomposer

3891
from openclaw/skills

Decomposes complex user requests into executable subtasks, identifies required capabilities, searches for existing skills at skills.sh, and creates new skills when no solution exists. This skill should be used when the user submits a complex multi-step request, wants to automate workflows, or needs help breaking down large tasks into manageable pieces.

Workflow & Productivity

first-1000-users

3891
from openclaw/skills

AI-powered Reddit seeding agent for founders. Analyzes a product spec, maps relevant subreddits, finds real threads where target users need help, drafts personalized replies and DMs, and posts approved outreach via Reddit API. Use when someone wants to find and engage their first users on Reddit, seed a product launch, or do community-led growth without a budget.

Marketing & Growth

investigation-first

3891
from openclaw/skills

触发:当你准备下判断、做决策或提出建议,但事实、上下文或一手信息还不充分时优先调用;常见信号包括 unknowns、信息缺口、证据不足、领域陌生、需要先摸清现状。 English: Trigger before making claims or decisions when context is incomplete, evidence is weak, or the domain is unfamiliar. Use this skill to investigate first, gather firsthand facts, and let reality shape the conclusion.

respond-first

3891
from openclaw/skills

Multi-agent dispatcher skill. Main agent acts as a pure coordinator — chatting with users and delegating all real work to 5 persistent sub-agents via round-robin scheduling with fixed sessionKeys.

first-principle-social-platform

3891
from openclaw/skills

A skill for OpenClaw agents to participate in First-Principle social platform. It uses a local claim-first flow: the agent builds a local claim URL, waits for a human owner to complete claim, and only then generates a per-agent ANP did:wba identity and platform session. It also supports identity-reuse login for session refresh without re-claiming.

principles

3891
from openclaw/skills

Ray Dalio-inspired personal knowledge system. Capture thoughts, track source credibility, detect conflicts with existing beliefs, and graduate wisdom into principles over time. Use when the user says /reflect, /inbox, /principles, /wisdom, /questions, or asks to capture a thought, process their inbox, review principles, or log wisdom.

Firstprinciples thinking

3891
from openclaw/skills

Think from first principles instead of analogy. Break problems into fundamental truths, challenge assumptions, and rebuild better solutions from scratch.

---

3891
from openclaw/skills

name: article-factory-wechat

Content & Documentation

humanizer

3891
from openclaw/skills

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Content & Documentation

find-skills

3891
from openclaw/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

General Utilities

tavily-search

3891
from openclaw/skills

Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.

Data & Research

baidu-search

3891
from openclaw/skills

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

Data & Research