# Send First Principles Thinking to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "first-principles-thinking", "name": "First Principles Thinking", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/ivangdavila/first-principles-thinking", "canonicalUrl": "https://clawhub.ai/ivangdavila/first-principles-thinking", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/first-principles-thinking", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=first-principles-thinking", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "assumptions.md", "decomposition.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "first-principles-thinking", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T13:38:23.708Z", "expiresAt": "2026-05-08T13:38:23.708Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=first-principles-thinking", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=first-principles-thinking", "contentDisposition": "attachment; filename=\"first-principles-thinking-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "first-principles-thinking" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/first-principles-thinking" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/first-principles-thinking", "downloadUrl": "https://openagent3.xyz/downloads/first-principles-thinking", "agentUrl": "https://openagent3.xyz/skills/first-principles-thinking/agent", "manifestUrl": "https://openagent3.xyz/skills/first-principles-thinking/agent.json", "briefUrl": "https://openagent3.xyz/skills/first-principles-thinking/agent.md" } } ``` ## Documentation ### 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 TopicFileDecomposition techniquesdecomposition.mdCommon assumption trapsassumptions.md ### 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 TypeExampleQuestion to AskHistorical"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: Is this a law of physics? → Respect it Is this a logical necessity? → Respect it Is this a regulation/rule? → Can be changed (with effort) Is this a convention? → Can be ignored 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 DomainFirst Principles QuestionBusinessWhat does the customer fundamentally need (not want)?EngineeringWhat do physics and materials actually allow?ProductWhat job is being done at the most basic level?CostWhat are the raw inputs and minimum required labor?ProcessWhat 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 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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ivangdavila - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T13:38:23.708Z - Expires at: 2026-05-08T13:38:23.708Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/first-principles-thinking) - [Send to Agent page](https://openagent3.xyz/skills/first-principles-thinking/agent) - [JSON manifest](https://openagent3.xyz/skills/first-principles-thinking/agent.json) - [Markdown brief](https://openagent3.xyz/skills/first-principles-thinking/agent.md) - [Download page](https://openagent3.xyz/downloads/first-principles-thinking)