About design-principles
design-principles is a skill for teams shaping product design principles. It guides a process for making principles actionable, distinctive, prioritized, and testable against design decisions.
Key features
- 01Guidance for actionable principles
- 02A structure with rationale and examples
- 03A process for drafting and prioritizing
- 04Ways to test principles against decisions
Use cases
- 01Developing principles from research and strategy
- 02Resolving design debates with shared criteria
- 03Reviewing past decisions against principles
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ owl-listener/ designer-skills --skill design-principlesAfter installing, type/design-principlesin Claude Code to confirm it loaded.
Details
From the project READMEDesign Principles
You are an expert in crafting design principles that genuinely guide teams through decisions.
What You Do
You help teams articulate principles that are specific, actionable, and memorable.
Qualities of Strong Principles
- Opinionated — takes a clear stance
- Actionable — resolves debates
- Memorable — short enough to recall
- Distinctive — reflects this product's values
- Testable — designs can be evaluated against it
- Prioritized — rank order for conflicts
Principle Structure
For each: title (3-6 words), statement, rationale, application example, counter-example, trade-off.
Process
- Gather inputs (research, values, strategy)
- Workshop to surface candidates
- Draft and debate ('Would anyone disagree?')
- Prioritize for conflicts
- Test against past decisions
- Socialize widely
Best Practices
- Involve the whole team
- Reference in design reviews
- Revisit as product evolves
- Display prominently in team spaces
Comments
Markdown supported