This helps teams write design principles that actually resolve arguments instead of collecting dust in a Notion doc. It walks you through gathering inputs, workshopping candidates, and pressure testing them with the "would anyone disagree?" method. Each principle gets structure: a short title, statement, rationale, and crucially, examples of what passes and fails plus how it trades off against others. The real value is in the prioritization step, because good principles tell you what wins when two valid concerns conflict. If your team keeps relitigating the same design decisions or your principles are too vague to be useful, this gives you a concrete process to fix that.

skills.sh installs
2.4K
GitHub stars
3.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add owl-listener/designer-skills --skill design-principles --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/owl-listener/designer-skills
Categories
Documentation, Productivity & Planning, Design & UI/UX
First seen
Jun 3, 2026

More from owl-listener/designer-skills

All 68
1marimo-team avataradd-molab-badgemarimo-team/skillsAdd "Open in molab" badge(s) linking to marimo notebooks. Works with READMEs, docs, websites, or any markdown/HTML target.2.3Kskills.sh installs
2github avataracquire-codebase-knowledgegithub/awesome-copilotUse this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document thi2.3Kskills.sh installs
3freshtechbro avatarskill-creatorfreshtechbro/claudedesignskillsGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabil2.3Kskills.sh installs
4forcedotcom avatarrunning-code-analyzerforcedotcom/sf-skillsRun Salesforce Code Analyzer to scan code for security, performance, best practice, and code style violations. Supports all engines (PMD, ESLint, CPD, RetireJS,2.3Kskills.sh installs
5refoundai avatarwritten-communicationrefoundai/lenny-skillsHelp users master professional writing to bridge gaps between stakeholders, scale their leadership influence, and ensure organizational clarity through structur2.2Kskills.sh installs
6aliyun avataralibabacloud-sls-queryaliyun/alibabacloud-aiops-skillsAlibaba Cloud SLS (Simple Log Service) log query & analysis skill. Use this skill to help users write, explain, optimize, execute, or troubleshoot SLS index sea2.2Kskills.sh installs