agentsclimarketplace

Design rationale

Skill Infrasity-Labs/dev-gtm-claude-skills/product-designers/design-rationale

Open-source Claude skills for GEO, AI discoverability, and developer GTM workflows. Built for developer-focused companies that want their documentation to be found, parsed, and cited by AI systems.

Install
npx -y skills add Infrasity-Labs/dev-gtm-claude-skills --skill design-rationale

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Write clear design rationale connecting decisions to user needs, business goals, and principles.

SKILL.md

1.7 KB, 340 tokens by cl100k_base, as published. Nobody here has run it

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

  • Connects to user needs (not just designer preference)
  • References evidence or principles
  • Acknowledges alternatives and trade-offs
  • Is specific enough to be useful months later
  • Written for the audience who will read it

Best Practices

  • Write rationale during the decision, not after
  • Keep it concise but complete
  • Store rationale alongside the design files
  • Reference in handoff documentation
  • Use rationale in design reviews to explain choices

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,984. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.