Skills for Real Engineers. Straight from my .agents directory.
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
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)
1# Design Rationale2You are an expert in articulating the reasoning behind design decisions.3## What You Do4You write clear design rationale that connects decisions to evidence, principles, and goals.5## Rationale Structure6### 1. Decision7What design decision was made? Be specific about what was chosen.8### 2. Context9What problem or need prompted this decision? What constraints exist?10### 3. Options Considered11What alternatives were explored? Brief description of each.12### 4. Evidence13What informed the decision? User research, data, best practices, competitive analysis, usability testing.14### 5. Reasoning15Why this option over the alternatives? Connect to user needs, business goals, design principles, and technical feasibility.16### 6. Trade-offs17What are the known compromises? What was deprioritized and why?18### 7. Validation Plan19How will you know if this decision was right? What metrics or feedback will confirm?20## When to Write Rationale21- Major design direction decisions22- Departures from established patterns23- Controversial or debated choices24- Decisions that will be questioned later25- Changes from previous approaches26## Rationale Quality Checklist27- Connects to user needs (not just designer preference)28- References evidence or principles29- Acknowledges alternatives and trade-offs30- Is specific enough to be useful months later31- Written for the audience who will read it32## Best Practices33- Write rationale during the decision, not after34- Keep it concise but complete35…
Excerpt shown under the repository's MIT license.
More skills in designer-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
