.agents/skills/first-principles/SKILL.md
Strip a problem to its irreducible fundamental truths and rebuild the solution from the ground up — free from analogy, convention, and inherited assumptions. Load when the user feels constrained by how something has always been done, when existing solutions feel expensive or inefficient for no good reason, when the user asks to think from first principles, challenge the fundamentals, or rebuild this from scratch. Also triggers on "why does it have to work this way", "what are the actual constraints here", "ignore what everyone else does", or when deep-thinking diagnoses a convention-break frame. Based on Aristotle's first principles method, popularised by Musk and Feynman. Produces genuinely novel solutions by eliminating convention.
npx skillsauth add dvy1987/agent-loom first-principlesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a first principles analyst. You strip problems to their irreducible truths and rebuild from the ground up. You distinguish between what is physically/logically necessary and what is merely conventional. You produce solutions that bypass inherited constraints.
Separate physical constraints from conventional ones. Physics is a constraint. "We've always done it this way" is not. "Regulations require X" is a real constraint. "The industry standard is X" is not.
Each fundamental truth must be independently verifiable. Not "this is what experts say" — but what can be directly confirmed from evidence or first principles reasoning.
Always rebuild. Analysis without synthesis is incomplete. First principles thinking produces a new solution, not just a critique of the old one.
Skip this if: Skip if: an existing solution is demonstrably working and the constraint is real (not just conventional). Skip if: the user needs speed over innovation. Use only when the existing approach has a fundamental constraint worth questioning.
Step 1 — Define the problem without assuming a solution State what outcome you actually want — not the method you've been using. Bad: "How do we make our onboarding faster?" Good: "How do we get a user to their first successful outcome as quickly as possible?"
Step 2 — List all current assumptions What does the current approach assume? List every "given", "obviously", and "always". Examples: "Users need an account before accessing value." "Onboarding must be sequential." "We need 7 data fields to start."
Step 3 — Challenge each assumption For each: Is this physically/logically necessary, or is it conventional?
Step 4 — Find the fundamental truths What remains after removing conventional assumptions? State them clearly: "The fundamental constraint is X. Everything else is a choice."
Step 5 — Validate Test each fundamental truth against reality. Can it be directly observed or logically derived without assuming the existing approach?
Step 6 — Rebuild from the fundamentals Design a new solution using only validated fundamentals. What does it look like when you ignore inherited design and start from truths?
Ask one question if needed: "What outcome do you actually want — not how you currently get it?"
Work through them out loud. Show the user which assumptions survive challenge and which are conventional.
First Principles Analysis: [problem]
FUNDAMENTAL TRUTHS (what must be true regardless of approach)
1. [Truth — verifiable, not conventional]
2. [Truth]
CONVENTIONAL CONSTRAINTS (things that feel necessary but aren't)
1. [Assumption] → can be eliminated or changed because: [reason]
2. [Assumption] → alternative: [option]
REBUILT SOLUTION
Starting from only the fundamental truths:
[Solution that bypasses conventional constraints]
EXPECTED DELTA
What this enables that the conventional approach cannot: [specific]
CONVENTIONAL CONSTRAINTS
FUNDAMENTAL TRUTHS (remaining)
REBUILT SOLUTION Remove the account gate entirely. Let the user do the core action immediately (anonymously). Prompt for email only when they want to save or share their work. Eliminate all 14 steps except the one that delivers the core outcome.
EXPECTED DELTA A user can experience value in <2 minutes instead of completing 14 steps. Activation rate should improve significantly — most drop-off is pre-value, not post-value. </output> </example> </examples>
First principles analysis: [problem]
Assumptions challenged: N
Conventional constraints identified: N
Fundamental truths confirmed: N
New solution built: yes
development
Run a fast, read-only health check across all skills in the library and produce a structured quality report — without modifying anything. Load when the user asks to validate skills, check skill health, audit the library, run a skill quality check, or when improve-skills needs a pre-flight before starting its cycle. Also triggers on "what's wrong with my skills", "check all skills", "skill health report", "are my skills ok", or "pre-flight check". Called automatically by improve-skills before any improvement work begins, and by universal-skill-creator after every new skill is created. Never modifies any file — only reads and reports.
tools
Design, build, validate, and ship production-grade agent skills that work across OpenAI Codex, Ampcode, Factory.ai Droids, Google Gemini, Warp, Bolt.new, Replit, GitHub Copilot, Claude Code, VS Code, Cursor, and any agentskills.io compliant platform. Load when the user asks to create a skill, build a custom skill, write a SKILL.md, package instructions as a reusable agent capability, convert a workflow into a skill, improve or audit an existing SKILL.md, generate a meta-skill, make a cross-platform skill, turn a repeated task into automation, or design agent skills that target multiple AI coding tools simultaneously. Also load for skill stacking, skill scoping, skill discovery, parameterized skills, skill publishing to GitHub or skills.sh, or when the user says skill creator, skill architect, or skill engineer.
tools
Identify the right tool for a process step. Load when a user or skill needs to check tool availability, confirm CLI compatibility, or determine if an MCP server is needed. Triggers on "what tool", "do I need an MCP", "is [tool] available", "which tool handles", "tool lookup", "check tool availability", "find a tool for". Called by process-decomposer and agent-builder when assigning tools to steps.
development
Apply the Red-Green-Refactor cycle to software development. Load when the user asks to write code using TDD, create unit tests, implement a feature with test coverage, refactor code, or ensure software quality through automated testing. Also triggers on "test-driven development", "write tests first", "TDD this feature", "Red-Green-Refactor", "ensure 100% test coverage", or any request to build software with a test-first approach. Supports unit, integration, and end-to-end testing strategies.