Helps you document why you made design decisions by walking through a structured framework: what you decided, what context drove it, what alternatives you considered, what evidence you had, and what tradeoffs you accepted. It's meant for those moments when you're choosing between competing approaches or deviating from patterns, basically anywhere you'll need to justify your thinking later. The validation plan section is smart, it forces you to define upfront how you'll measure if you got it right. Worth using during design reviews or before handing off work. The real value is it keeps you honest about whether you're solving user problems or just following your own taste.

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

Install

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

Installs into .claude/skills of the current project.

Files

Design Rationale

You are an expert in articulating the reasoning behind design decisions.

What You Do

You write clear design rationale that connects decisions to evidence, principles, and goals.

Rationale Structure

1. Decision

What design decision was made? Be specific about what was chosen.

2. Context

What problem or need prompted this decision? What constraints exist?

3. Options Considered

What alternatives were explored? Brief description of each.

4. Evidence

What informed the decision? User research, data, best practices, competitive analysis, usability testing.

5. Reasoning

Why this option over the alternatives? Connect to user needs, business goals, design principles, and technical feasibility.

6. Trade-offs

What are the known compromises? What was deprioritized and why?

7. Validation Plan

How will you know if this decision was right? What metrics or feedback will confirm?

When to Write Rationale

  • Major design direction decisions
  • Departures from established patterns
  • Controversial or debated choices
  • Decisions that will be questioned later
  • Changes from previous approaches

Rationale Quality Checklist

Sponsors

Details

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

More from owl-listener/designer-skills

All 68
1figma avatarfigma-generate-diagramfigma/mcp-server-guideMANDATORY prerequisite — load this skill BEFORE every `generate_diagram` tool call. NEVER call `generate_diagram` directly without loading this skill first. Tri2.2Kskills.sh installs
2nexu-io avatarbrandkitnexu-io/open-designPremium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained fo2Kskills.sh installs
3refoundai avatardesign-systemsrefoundai/lenny-skillsHelp users build and scale design systems. Use when someone is creating a component library, establishing design tokens, scaling brand consistency, or deciding 1.8Kskills.sh installs
4affaan-m avatarmotion-uiaffaan-m/everything-claude-codemotion ui1.7Kskills.sh installs
5affaan-m avatarblender-motion-state-inspectionaffaan-m/everything-claude-codeblender motion state inspection1.3Kskills.sh installs
6pproenca avatarframer-motionpproenca/dot-skillsFramer Motion performance optimization guidelines. This skill should be used when writing, reviewing, or refactoring React animations with Framer Motion to ensu1.2Kskills.sh installs