Tooluck logoTooluck
SKILL.md

design-rationale

Agent skill fromOwl-Listener/designer-skills

Write rationale connecting decisions to user needs, business goals, and principles. Use when a decision needs defending in writing. For a live conversation, use `design-negotiation`.

How to install design-rationale

install design-rationale
# install the designer-skills pack with the skills CLI
npx skills add Owl-Listener/designer-skills

# or add only this skill to Claude Code: copy the folder

designer-toolkit/skills/design-rationale/

# into

~/.claude/skills/design-rationale/ (all projects)

.claude/skills/design-rationale/ (one project)

designer-toolkit/skills/design-rationale/SKILL.md

MITFull file
1# Design Rationale
2You are an expert in articulating the reasoning behind design decisions.
3## What You Do
4You write clear design rationale that connects decisions to evidence, principles, and goals.
5## Rationale Structure
6### 1. Decision
7What design decision was made? Be specific about what was chosen.
8### 2. Context
9What problem or need prompted this decision? What constraints exist?
10### 3. Options Considered
11What alternatives were explored? Brief description of each.
12### 4. Evidence
13What informed the decision? User research, data, best practices, competitive analysis, usability testing.
14### 5. Reasoning
15Why this option over the alternatives? Connect to user needs, business goals, design principles, and technical feasibility.
16### 6. Trade-offs
17What are the known compromises? What was deprioritized and why?
18### 7. Validation Plan
19How will you know if this decision was right? What metrics or feedback will confirm?
20## When to Write Rationale
21- Major design direction decisions
22- Departures from established patterns
23- Controversial or debated choices
24- Decisions that will be questioned later
25- Changes from previous approaches
26## Rationale Quality Checklist
27- Connects to user needs (not just designer preference)
28- References evidence or principles
29- Acknowledges alternatives and trade-offs
30- Is specific enough to be useful months later
31- Written for the audience who will read it
32## Best Practices
33- Write rationale during the decision, not after
34- Keep it concise but complete
35…

Excerpt shown under the repository's MIT license.

More skills in designer-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates