mcpField
D
design-principles

design-principles

github.com/owl-listenerDesign & UI3.1k2.2k installsUpdated 8w ago
Repository

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

  1. 01Guidance for actionable principles
  2. 02A structure with rationale and examples
  3. 03A process for drafting and prioritizing
  4. 04Ways to test principles against decisions

Use cases

  1. 01Developing principles from research and strategy
  2. 02Resolving design debates with shared criteria
  3. 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-principles

After installing, type/design-principlesin Claude Code to confirm it loaded.

Details

From the project README

Design 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

  1. Gather inputs (research, values, strategy)
  2. Workshop to surface candidates
  3. Draft and debate ('Would anyone disagree?')
  4. Prioritize for conflicts
  5. Test against past decisions
  6. Socialize widely

Best Practices

  • Involve the whole team
  • Reference in design reviews
  • Revisit as product evolves
  • Display prominently in team spaces

Comments

Markdown supported