agentleFS
parhambparhamb/design-skills/ux-review/SKILL.md

ux-review

Skill21 starsChanged 5 months agoMITView on GitHub

Entry point for full UX reviews, design audits, and product feedback. Use when asked to review a screen, flow, feature, or entire app; audit UX or design quality; or give structured product feedback. Routes to the category skills that apply and defines the shared review output format.

26 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 24 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep verdicts honest: if something cannot be verified from the material provided (e.g.

    line 63
  2. Distinctive:

    Evidence over opinion: every Fail cites where it happens.

    line 71

“Common” is measured: kept by at least 6 in 10 of the 24 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

UX Review (Router)

A real UX review almost never fits inside one category. A single screen can raise visual, accessibility, content, and error-handling issues at the same time. This skill maps the request to the category skills to read, and defines the output format every review follows.


Review Process

  1. Identify the scope: a single screen, a flow (onboarding, checkout), a feature (search, notifications), or the whole app.
  2. Select the category skills using the routing table below. Read every skill that applies — most reviews need 3 to 5.
  3. Apply each checklist: mark every item Pass, Fail, or N/A with specific evidence (screen, component, file, or line).
  4. Report using the output format below.

Routing Table

What is being reviewedSkills to read
Any screen (always)ux-visual-design, ux-accessibility, ux-content
Onboarding / first runux-help-onboarding, ux-user-account, ux-safety-privacy
Login / sign-up / authux-user-account, ux-forms, ux-safety-privacy
Forms / checkout / data entryux-forms, ux-error-handling, ux-information-architecture
Search / discoveryux-search, ux-information-architecture
Navigation / app structureux-navigation, ux-information-architecture
Settings / preferencesux-settings, ux-notifications, ux-safety-privacy
Errors / offline / edge casesux-error-handling, ux-network
Notificationsux-notifications, ux-settings
AI features / automationux-ai-automation, ux-content
Sharing / favorites / power featuresux-utility
Whole app / store readinessux-general plus every category the app's surfaces touch

Output Format

Structure every review like this:

  1. Summary — 2 to 4 sentences: overall quality, the biggest risk, the biggest strength.
  2. Findings by category — one section per skill applied, containing a table: Item | Verdict (Pass / Fail / N/A) | Evidence | Severity. Severity is Blocker (breaks the experience), Major (hurts usability), or Minor (polish).
  3. Top fixes — the 3 to 5 highest-impact changes, ranked, each with a concrete recommendation (not just a restatement of the problem).

Keep verdicts honest: if something cannot be verified from the material provided (e.g. screen reader behavior from a static screenshot), mark it N/A — needs testing rather than guessing.


Review Principles

  • Evidence over opinion: every Fail cites where it happens.
  • Severity over volume: 5 ranked issues beat 50 unranked ones.
  • User impact framing: describe what the user experiences, not just what rule is violated.
  • Acknowledge what works: reviews that only list problems lose the reader's trust in the calibration of the findings.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.