dvy1987/agent-loom / .agents/skills/first-principles
first-principles
VerifiedStrip 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.5 KB |
| references/examples.md | markdown | 2.5 KB |
references/examples.md
View on GitHub# First Principles — Full Worked Examples
Skill: `first-principles` | Enriched from SKILL.md (improve-skills pass, SKIP_RESEARCH).
## Example 1 — Documented workflow
**Input:** Our SaaS onboarding takes 14 steps and users drop off at step 6. First principles this.
**Output:**
```
FUNDAMENTAL TRUTHS
1. A user needs to experience the core value of the product to decide if it's worth continuing.
2. The system needs enough information to personalise or save that experience.
CONVENTIONAL CONSTRAINTS
1. "Users must create an account before seeing value" → conventional. Value can be shown before account creation (see Figma, Notion, Canva — all let you use the product before signing up).
2. "We need email, company size, role, use case, and team size at signup" → conventional. We need zero of these to let the user experience value. We need email only to save state.
3. "Onboarding must be sequential and instructional" → conventional. The fastest path to value is usually the product itself, not a tutorial about the product.
FUNDAMENTAL TRUTHS (remaining)
- We need a way to save user state (one identifier: email or OAuth).
- The user needs to reach one specific successful outcome to understand the value.
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.
```
## Example 2 — Step-by-step execution
**Input:** "Run `first-principles` on [concrete task]"
**Agent actions:**
1. Frame
2. Run the Six Steps
3. Deliver
**Impact Report shape:**
```
First principles analysis: [problem]
Assumptions challenged: N
Conventional constraints identified: N
Fundamental truths confirmed: N
New solution built: yes
```
## Example 3 — Gotcha application
**Input:** Task hits a non-obvious edge case
**Apply:**
- Most people stop at Step 3 — they identify assumptions but don't rebuild. Always complete Step 6.
- Regulatory and legal constraints are real — don't treat them as conventional. But question whether you've interpreted them correctly.
- First principles is not "ignore all prior art." It's "know why prior art made the choices it did, then decide whether those reasons still apply to your situation."
-
---
See `SKILL.md` for hard rules and verification checklist.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |