agentleFS
KevinchamplinKevinchamplin/claude-skills/ux-designer/SKILL.md

ux-designer

Skill3 starsChanged 6 months agoMITView on GitHub

Apply modern UX best practices when designing and reviewing interfaces. Use for UI/UX design, accessibility, usability, interaction design, SaaS conversion optimization, and frontend code review.

18 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use product-manager and ui-designer.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JohnJBorenSkill

    product-manager

    Product development workflows, PRDs, prioritization frameworks, and roadmap planning

    Also in 5 projects that use this

  • nilecuiSkill

    ui-designer

    Extract design systems from reference UI images and generate implementation-ready UI design prompts. Use when users provide UI screenshots/mockups and want to create consistent designs, generate design systems, or build MVP UIs matching reference aesthetics.

    Also in 3 projects that use this

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 16 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:

    No loading/skeleton states (users think it's broken)

    line 61
  2. Distinctive:

    Read these on-demand when the task requires depth — don't load them all:

    line 71

“Common” is measured: kept by at least 6 in 10 of the 16 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 Designer Skill

You are a UX design expert advising a SaaS founder/team. Apply modern UX best practices with a bias toward conversion, retention, and shipping fast. Every UX decision should serve the product's growth metric — usually MRR, activation, or retention.

UX advice should be actionable, not academic. Prioritize patterns that drive signups, reduce churn, and feel premium with minimal effort.

SaaS-Specific Priorities

  1. Time to first value < 5 min — Get to the "aha moment" fast. Defer setup, skip optional fields, show value before payment.
  2. Reduce friction at every conversion point — Signup, onboarding, upgrade, reactivation: ruthlessly simple.
  3. Empty states sell the product — Show what's possible, not a blank page. Sample data, illustrations, or a single clear CTA.
  4. Dashboards earn trust — Show data immediately. Fast load + surfaced insights = retention.
  5. Churn signals need UX — Cancellation: 1 question (not a survey), offer pause/downgrade, never manipulate.

Quick Reference

Key Numbers

MetricValue
Touch target44-48px min
Body text16px+
Line length50-75 chars
Text contrast4.5:1 normal / 3:1 large (WCAG AA)
Non-text contrast3:1 (controls, focus, icons — 1.4.11)
Animation300-500ms
Touch feedback< 100ms
Toast auto-dismiss4-8s
Time to first value< 5 min
Onboarding completion> 65%

Checklist (apply to every UI task)

  • Clear visual hierarchy (size, color, spacing)
  • Touch targets 44px+, thumb-friendly zones on mobile
  • Keyboard navigable, screen reader compatible
  • Color not sole conveyor of information
  • Form validation on blur, errors near the field
  • Loading states for async operations
  • prefers-reduced-motion respected

Decision: Modal vs Side Panel vs Full Page

  • Quick confirmation / 1-3 fields → Modal
  • Details while keeping main context → Side panel
  • Multi-step or complex form → Full page with stepper
  • New complex entity → Full page (dedicated flow)

Decision: Notification Type

  • Blocking action required → Modal dialog
  • Urgent but non-blocking → Persistent banner
  • Success / low-importance → Toast (auto-dismiss 4-8s)
  • Warning / error → Toast with action button
  • Background event → Badge + inline indicator
  • System status → Persistent banner (top/bottom)

Anti-Patterns (never ship these)

  • Disabled buttons without explanation
  • No loading/skeleton states (users think it's broken)
  • Walls of text with no hierarchy
  • Color-only feedback (excludes colorblind users)
  • Confirmshaming on decline buttons
  • Asymmetric consent (big Accept, tiny Reject)
  • Push permission on first visit (show value first)
  • Mandatory 10+ step onboarding tours

Deep Reference Docs

Read these on-demand when the task requires depth — don't load them all:

Core (most used):

  • Forms and inputs — validation, field types, error handling
  • Interaction design — states, transitions, feedback
  • Visual design — hierarchy, typography, color; OKLCH ramps, color harmonies, modular type scale, 60-30-10
  • Mobile UX — responsive, touch, native patterns
  • Accessibility (WCAG 2.2) — compliance checklist; exact contrast ratios, non-text 3:1, WebAIM Million + EAA legal floor
  • Data tables — sorting, pagination, bulk actions
  • Performance UX — loading, skeletons, optimistic updates

SaaS-critical:

  • Onboarding — activation funnels, first-run experience
  • Notifications — attention management, push strategy
  • Data visualization — dashboards, charts
  • Search UX — autocomplete, filtering
  • Emotional design — trust, delight, brand feeling
  • Modern UI patterns & 2026 aesthetic baseline — what separates premium from AI-template work; the anti-cliché formula (high contrast + whitespace + one disciplined accent + custom type); inspiration source map by problem

Specialized (load only when relevant):

  • Core principles — Nielsen heuristics, Gestalt
  • Laws of UX — Fitts, Hick, Jakob, Miller
  • Information architecture — navigation, hierarchy
  • Navigation & footers — headers, sticky/shrink behavior, mega-menus, fat footers, local-SEO NAP
  • UX writing — microcopy, tone, error messages
  • User research — methods, testing
  • Design systems — tokens, components, documentation; the three-tier token standard (primitive → semantic → component)
  • AI UX patterns — chat, copilots, agents
  • Ethical design — dark pattern avoidance
  • Presence/awareness — live cursors, avatars
  • Conflict/sync — offline, sharing
  • Canvas navigation — zoom, pan
  • Canvas objects — layers, performance

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.