Tooluck logoTooluck
SKILL.md

thinking-first-principles

Agent skill fromtjboudreaux/cc-thinking-skills

When a constraint is treated as fixed, separate physics from convention, keep only independently supported primitives, and rebuild the simplest solution that satisfies real constraints.

How to install thinking-first-principles

install thinking-first-principles
# install the cc-thinking-skills pack with the skills CLI
npx skills add tjboudreaux/cc-thinking-skills

# or add only this skill to Claude Code: copy the folder

skills/thinking-first-principles/

# into

~/.claude/skills/thinking-first-principles/ (all projects)

.claude/skills/thinking-first-principles/ (one project)

skills/thinking-first-principles/SKILL.md

MITFull file
1# First Principles
2
3Strip assumed constraints to independently supported primitives, then rebuild. Escape analogy when convention fails or looks artificially expensive.
4
5## When to Use
6
7- A constraint is treated as fixed ("too expensive," "impossible," "always done this way") without independent support.
8- Convention or analogy has failed, stalled, or only yields weak incremental variants.
9- Greenfield design where industry defaults may smuggle false requirements.
10- Cost or feasibility claims rest on pricing, precedent, or authority rather than physics, math, or measured need.
11
12## When NOT to Use
13
14- The constraint is verified physics, hard regulation, or measured capacity → accept it and optimize within it.
15- A proven standard library, protocol, or known-good pattern already fits → use it; do not re-derive.
16- Time-critical incidents → act on the most likely cause first; reserve first-principles rebuild for post-incident redesign.
17- Incremental polish of a working system with no false-constraint signal → skip.
18
19## Procedure
20
211. **State the problem and claimed constraints.** List every limit treated as fixed (cost, scale, stack, process, "must use X").
222. **Classify each constraint.** Tag as `physics/math`, `regulation/contract`, `measured fact`, or `convention/analogy/authority`. Keep only the first three as binding unless evidence upgrades a convention.
23…

Excerpt shown under the repository's MIT license.

More skills in cc-thinking-skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates