Back to list
petekp

design-critique

by petekp

My personal Claude Code setup

10🍴 3📅 Jan 23, 2026

SKILL.md


name: design-critique description: Critique UI/UX designs for clarity, hierarchy, interaction, accessibility, and craft. Use for design reviews, PR feedback on UI changes, evaluating mockups, checking if a component is ship-ready, or when honest feedback is needed on whether something meets a high bar. allowed-tools:

  • Read
  • Glob
  • Grep
  • WebFetch
  • mcp__claude-in-chrome__*

Design Critique

Honest, specific, actionable feedback on interface design.

The Critique Stance

  • Be direct. No soft language. No vibes-only feedback.
  • Point to specifics, not generalities.
  • Explain why, not just what.
  • Reference principles, not preferences.
  • Offer fixes, not just problems.

Process

  1. Identify what you're critiquing - Screen, component, flow, or interaction
  2. Gather context - Platform, users, constraints (if available)
  3. Apply the lens - Clarity, hierarchy, interaction, accessibility, craft
  4. Prioritize issues - P0 (blocking) through P3 (polish)
  5. Propose fixes - Specific, actionable changes

Quick Check (Use CHECKLIST.md for detailed pass)

Clarity

  • Can users predict outcomes before acting?
  • Is the hierarchy of information obvious?
  • Are interactive elements clearly distinguished?

Interaction

  • Do all states exist? (hover, focus, active, disabled, loading, error)
  • Is feedback immediate?
  • Can users recover from errors?

Accessibility

  • Focus visible and logical?
  • Contrast sufficient?
  • Touch targets adequate (44x44pt)?

Output Contract

Structure every critique as:

## Verdict
[1 sentence: ship/iterate/rethink]

## Issues

### P0: [Issue Name]
- **What's wrong**: [Specific observation]
- **Why it matters**: [User impact]
- **Evidence**: [Element, screen, or behavior]
- **Fix**: [Actionable change]

### P1: [Issue Name]
...

## Accessibility Pass
- Focus visibility: [Pass / Issue + fix]
- Contrast: [Pass / Issue + fix]
- Touch targets: [Pass / Issue + fix]
- Motion: [Respects reduced-motion? / Issue]

## What's Working
[2-3 things done well - critique includes praise]

## Next Steps
- [ ] [Verification action 1]
- [ ] [Verification action 2]

Severity Levels

LevelDescriptionAction
P0Blocks task, causes confusion, or data lossMust fix before ship
P1Frequent friction, misclicks, unclear recoveryShould fix
P2Polish, efficiency, minor annoyanceFix if time permits
P3Nice-to-have refinementConsider for later

The Questions Behind Everything

  • "What is the user trying to do here?"
  • "What's the most important thing on this screen?"
  • "What would happen if we removed this?"
  • "Would a new user understand this?"
  • "Are we proud of this?"

Common Critique Notes

"Too busy": Too many things competing for attention. Remove until important things breathe.

"Not discoverable": Hidden functionality, unlabeled icons, gestures without affordance.

"Inconsistent": Different patterns for similar actions. Pick one and commit.

"Feels off": Usually spacing, alignment, or timing. The eye knows before the mind articulates.

"Overdesigned": Every effect turned up. Decoration overwhelming function. Subtract until inevitable.

Deep Reference

For detailed heuristics, common failures, and platform-specific patterns:

Score

Total Score

65/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon