How does this skill help with software engineering?

It allows teams to define clear technical principles—like 'optimize for readability'—which can then be applied systematically during code reviews and architectural planning.

What is principles-based thinking?

It is a methodology where you document fundamental truths and values to guide decisions consistently, rather than relying on case-by-case intuition.

Can I use this for personal productivity?

Yes, it helps individuals codify personal heuristics for finance, time management, and learning to reduce decision fatigue and improve long-term outcomes.

When should I use principles instead of rules?

Principles are best for complex, evolving environments where strict rules are too rigid, but a high degree of consistency and alignment is still required.

Principles-Based Thinking

Name: Principles-Based Thinking
Author: lev-os

bylev-os

0•

Productivity & Workflow

Codifies and applies fundamental truths to ensure consistent, scalable decision-making across complex domains and organizational cultures.

The Principles-Based Thinking skill enables Claude to move beyond rigid rules or inconsistent intuition by documenting a hierarchy of core beliefs and values. Inspired by Ray Dalio’s framework, this skill helps users capture insights from experience, create falsifiable guidelines, and resolve tensions between competing priorities like speed and quality. It is ideal for technical leaders building engineering cultures, product managers navigating trade-offs, and teams seeking to scale their decision-making logic without losing consistency.

Key Features

01Falsifiable principle drafting to ensure actionable guidance over vague platitudes

02Iterative refinement loops that update principles based on new empirical data

030 GitHub stars

04Systematic documentation of core principles from historical outcomes

05Creation of domain-specific principle libraries for engineering and product

06Conflict resolution mechanisms for competing values and trade-offs

Use Cases

01Scaling engineering culture by codifying shared architectural and code review standards

02Establishing consistent organizational norms and hiring criteria for growing teams

03Navigating complex product strategy decisions where simple rules fail to provide clarity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lev-os/agents principles-based-thinking

For use in Claude.ai and ChatGPT

Download Skill