Skip to content
Back to search

ux-designer

SkillWorks with Claude CodeGitHub

UX/UI design guidance for building, reviewing, and critiquing interfaces and frontend code. Use when designing screens or components, auditing usability or accessibility (WCAG 2.2, EAA), writing microcopy, or designing forms, navigation, search, tables, dashboards, onboarding, notifications, real-time collaboration, canvas/whiteboard apps, AI/chat interfaces, i18n/RTL, voice, design systems, barcode/QR scanning and display, or CLI/TUI and terminal apps.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/szilu-ux-designer-skill/badge.svg)](/listings/szilu-ux-designer-skill)

HTML

<a href="/listings/szilu-ux-designer-skill"><img src="/api/listings/szilu-ux-designer-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Clone the repository into your Claude Code skills directory:

# Personal (all projects)
git clone https://github.com/szilu/ux-designer-skill.git ~/.claude/skills/ux-designer

# Or project-only
git clone https://github.com/szilu/ux-designer-skill.git .claude/skills/ux-designer

Or download a release archive and extract it to one of those paths. The directory name (`ux-designer`) is the skill name.

The skill is invocable by both user (`/ux-designer`) and Claude (auto-triggered when UX topics arise).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 189 lines
  1. ---
  2. name: ux-designer
  3. description: UX/UI design guidance for building, reviewing, and critiquing interfaces and frontend code. Use when designing screens or components, auditing usability or accessibility (WCAG 2.2, EAA), writing microcopy, or designing forms, navigation, search, tables, dashboards, onboarding, notifications, real-time collaboration, canvas/whiteboard apps, AI/chat interfaces, i18n/RTL, voice, design systems, barcode/QR scanning and display, or CLI/TUI and terminal apps.
  4. ---
  5. # UX Designer
  6. Use this skill for three jobs: **reviewing** an interface (a screenshot, a URL, or code), **building** UI, and **advising** on a design decision. You know the general UX canon already. This file gives you the workflows, the numbers, and the calls that are easy to get wrong. The reference files go deeper, so load only the ones the task needs (see the routing table).
  7. ## Philosophy
  8. - **Calm over clever.** Motion, color, and density have to help the user understand something. Decoration that only impresses is noise.
  9. - **Judgment over polish.** Anyone can generate polished UI now, so the value is in correctness, research, and knowing what to leave out.
  10. - **AI as copilot, not autopilot.** AI assistance is optional, labeled, reversible, and the user stays in control.
  11. - **Adapt to real needs.** Avoid opaque or manipulative personalization.
  12. ## Workflow: Reviewing or auditing a UI
  13. 1. **Establish context.** Identify the users, their primary task, the platform, and any stated constraints (brand, design system, legal regime). If there's no context, assume a general audience and say so.
  14. 2. **Look at the real thing.** Render it if you can: take a screenshot or open it in the browser. Walk through the primary task with the keyboard only, and run an automated checker (axe, Lighthouse) when a browser is available. Reading code alone misses contrast, overflow, focus order, and layout at other widths.
  15. 3. **Check at the extremes.** Try 320px width, 200% zoom, a long translated string, empty data, huge data, a slow network, an error state, and `dir="rtl"` if the product is localized.
  16. 4. **Report findings ranked by user impact**, not in checklist order:
  17. ```
  18. [Blocker|Major|Minor] <what is wrong> — <who it hurts and how>
  19. Where: <screen/component or file:line>
  20. Fix: <concrete change> Ref: <heuristic / WCAG SC / reference file>
  21. ```
  22. A blocker stops a user from completing the task, or it's a legal accessibility failure. Cite WCAG success criteria by number (for example, 2.4.11 Focus Not Obscured). Skip praise padding. If a pass finds nothing serious, say that plainly.
  23. ## Workflow: Building UI
  24. 1. **Reuse before inventing.** Look for an existing design system, tokens, component library, and nearby screens. Match them, even where your own taste differs.
  25. 2. **Design every state,** not only the happy path: empty, loading, partial, error, offline, permission-denied, and overflow (long names, 0/1/many items).
  26. 3. **Semantics first.** Start from native elements (`<button>`, `<label>`, `<dialog>`, `<details>`, `<input type=…>`). Add ARIA only when no native element fits.
  27. 4. **Verify by looking.** Render the result. Check it at mobile width, with the keyboard, and in dark mode if the product supports it. Fix what you see and check again.
  28. ### Generated-UI defaults to avoid
  29. These are telltale marks of model-generated interfaces. Don't use them unless the brand calls for them:
  30. - Purple/indigo gradients, glassmorphism, and glow shadows used as default styling
  31. - Emoji standing in for icons, and decorative icons on every heading or list item
  32. - A card around everything, nested cards, and every section centered with the same padding
  33. - Hero sections, testimonials, and marketing filler inside app UI that doesn't need them
  34. - Lorem-ipsum-perfect sample data: use realistic lengths, names from several locales, and edge cases
  35. - Buttons that all carry equal visual weight, with no single primary action
  36. - Gray-on-gray low-contrast "minimal" text
  37. - Hover-only affordances with no touch or keyboard equivalent
  38. ## Core rules
  39. **Visual.** Give each screen one dominant element. Body text is 16px or larger, with 1.4–1.6 line height and 50–75 characters per line. Text contrast is at least 4.5:1, or 3:1 for large text and UI component boundaries. Take all spacing from one 4px or 8px scale.
  40. **Interaction.** Show visible feedback within 100ms. Most UI transitions run 150–300ms, and only large or spatial motion goes up to 500ms. Honor `prefers-reduced-motion`. On mobile, put primary actions in the thumb zone. Never disable a button without saying why.
  41. **Forms.** Put labels above fields and never use placeholder-only labels. Validate on blur and re-validate on input once a field has shown an error. Show errors next to the field and summarize them at submit. Ask only for what you need. Mark whichever set of fields is the minority, required or optional.
  42. **Navigation.** The current location is always visible. Keep the top level scannable: about 5–7 items on desktop and 3–5 in a mobile bottom bar. Miller's 7±2 is a working-memory figure, not a menu rule. On desktop, don't hide primary navigation behind a hamburger.
  43. **Accessibility.** Everything is operable by keyboard, and focus is visible and never hidden behind sticky UI. Every control has an accessible name and role. Color is never the only signal. Images have meaningful alt text, or `alt=""` if they're decorative. Targets are at least 24×24 CSS px (WCAG 2.5.8 AA), with 44pt (iOS) or 48dp (Android) recommended on touch. Treat WCAG 2.2 AA as the legal target. WCAG 3 is still a draft.
  44. **Collaboration.** Show presence (avatars, cursors, selections), make sync and offline state visible, keep undo per client, and state permission levels plainly.
  45. **Canvas.** Zoom around the cursor, not the screen center. Snapping has a toggle. Provide a minimap for large boards, full keyboard navigation, and viewport culling.
  46. **AI.** Label AI content, attribute sources, and provide stop/cancel, edit/regenerate, feedback, and undo for any AI-applied change. Keep a human override.
  47. **Onboarding.** Guide the user to the first real value, not a tour. Make it skippable and never show it again once finished. Empty states give the next action.
  48. **Notifications.** Match visual severity to real severity. Ask for push permission in context, after the user has seen value. Give users per-channel control. Toasts auto-dismiss after 4–8s, except toasts that carry an action, which stay until dismissed (WCAG 2.2.1).
  49. **Ethics.** Accept and reject get equal prominence. Optional consent boxes start unchecked. Cancelling is as easy as signing up. No confirmshaming.
  50. **i18n.** Use logical CSS properties and verify the layout in `dir="rtl"`. Allow 30–40% text expansion and no fixed-width labels. Externalize all strings and keep text out of images. Format dates, numbers, and currency with `Intl`, and handle plurals with ICU rules. Language switchers use endonyms, not flags.
  51. ## Decision trees
  52. ### Modal vs. side panel vs. full page
  53. ```
  54. Quick confirmation or 1-3 fields? → Modal
  55. Edit details while keeping context visible?
  56. narrow content (form, properties, chat) → Side panel
  57. needs width → Full-page overlay with back
  58. Multi-step: short steps → modal + stepper; long steps / needs reference → full page + stepper
  59. Creating a complex entity (document, project)? → Full page
  60. ```
  61. ### Notification type
  62. ```
  63. Blocking, must resolve now → Modal
  64. Urgent, non-blocking → Banner, persistent until dismissed
  65. Completed action: success/info → Toast, auto-dismiss 4-8s
  66. Completed action: warning/error or has action → Toast, manual dismiss
  67. Background event, same context → Badge + inline indicator
  68. Background event, elsewhere → Nav badge (+ optional push)
  69. System status (maintenance, connectivity) → Persistent banner
  70. ```
  71. ## Reference routing
  72. Load the file when the task touches its topic. Each file opens with a table of contents, so you can jump to the section you need.
  73. | Load when the task involves… | File |
  74. |---|---|
  75. | Heuristic evaluation, Nielsen's 10, Gestalt | [references/01-core-principles.md](references/01-core-principles.md) |
  76. | Fitts, Hick, Jakob, Tesler, peak-end, and similar laws | [references/02-laws-of-ux.md](references/02-laws-of-ux.md) |
  77. | WCAG 2.2 criteria, ARIA, EAA / legal compliance | [references/03-accessibility.md](references/03-accessibility.md) |
  78. | Typography, color, spacing, hierarchy, dark mode | [references/04-visual-design.md](references/04-visual-design.md) |
  79. | Navigation structure, sitemaps, card sorting | [references/05-information-architecture.md](references/05-information-architecture.md) |
  80. | Modals, tooltips, drag-and-drop, motion timing | [references/06-interaction-design.md](references/06-interaction-design.md) |
  81. | Form layout, validation, input types, errors | [references/07-forms-and-inputs.md](references/07-forms-and-inputs.md) |
  82. | Touch targets, gestures, responsive, mobile nav | [references/08-mobile-ux.md](references/08-mobile-ux.md) |
  83. | Microcopy, error messages, voice and tone | [references/09-ux-writing.md](references/09-ux-writing.md) |
  84. | Interviews, usability tests, surveys, metrics | [references/10-user-research.md](references/10-user-research.md) |
  85. | Tokens, component APIs, design system docs | [references/11-design-systems.md](references/11-design-systems.md) |
  86. | Live cursors, avatars, typing/presence indicators | [references/12a-presence-awareness.md](references/12a-presence-awareness.md) |
  87. | Conflicts, sync, offline, sharing, version history | [references/12b-conflict-resolution-sync.md](references/12b-conflict-resolution-sync.md) |
  88. | Canvas zoom, pan, selection, manipulation | [references/13a-canvas-navigation.md](references/13a-canvas-navigation.md) |
  89. | Canvas layers, snapping, LOD, rendering performance | [references/13b-canvas-objects-performance.md](references/13b-canvas-objects-performance.md) |
  90. | Chat UI, copilots, agents, generative UI | [references/14-ai-ux-patterns.md](references/14-ai-ux-patterns.md) |
  91. | Dark patterns, consent, DSA/GDPR UI rules | [references/15-ethical-design.md](references/15-ethical-design.md) |
  92. | First-run, activation, empty states, checklists | [references/16-onboarding.md](references/16-onboarding.md) |
  93. | Notification systems, push, toasts, preferences | [references/17-notifications.md](references/17-notifications.md) |
  94. | Charts, dashboards, accessible data viz | [references/18-data-visualization.md](references/18-data-visualization.md) |
  95. | Search, autocomplete, filters, zero results | [references/19-search-ux.md](references/19-search-ux.md) |
  96. | Delight, trust, tone, error recovery emotion | [references/20-emotional-design.md](references/20-emotional-design.md) |
  97. | Tables, sorting, pagination, bulk actions | [references/21-data-tables.md](references/21-data-tables.md) |
  98. | Loading, skeletons, optimistic updates, Core Web Vitals | [references/22-performance-ux.md](references/22-performance-ux.md) |
  99. | Localization, RTL, `Intl`, plurals, text expansion | [references/23-internationalization.md](references/23-internationalization.md) |
  100. | Voice, multimodal, cross-device input | [references/24-voice-and-multimodal.md](references/24-voice-and-multimodal.md) |
  101. | Camera barcode/QR scanning on phone or web, viewfinder, QR safety | [references/25a-barcode-camera-scanning.md](references/25a-barcode-camera-scanning.md) |
  102. | Scan-driven apps: warehouse, POS, healthcare, rugged or wedge scanners, GS1 | [references/25b-barcode-scanner-workflows.md](references/25b-barcode-scanner-workflows.md) |
  103. | Showing barcodes/QR: tickets, wallet passes, QR login, printed labels | [references/25c-barcode-display.md](references/25c-barcode-display.md) |
  104. | CLI commands, flags, help, stdout/stderr, exit codes, prompts, config, agent-friendly CLIs | [references/26a-cli-design.md](references/26a-cli-design.md) |
  105. | Terminal colour, progress, tables, terminal a11y; full-screen/inline TUIs, keybindings, rendering | [references/26b-terminal-output-and-tui.md](references/26b-terminal-output-and-tui.md) |
  106. ## Reference values
  107. | Metric | Value | Source / note |
  108. |---|---|---|
  109. | Target size | ≥ 24×24 CSS px (AA); 44pt iOS / 48dp Android | WCAG 2.5.8; Apple HIG; Material |
  110. | Body text | ≥ 16px, line height 1.4–1.6 | WCAG 1.4.12 tests up to 1.5 |
  111. | Line length | 50–75 characters | |
  112. | Text contrast | 4.5:1 normal, 3:1 large (≥ 24px, or ≥ 18.66px bold) | WCAG 1.4.3 |
  113. | Non-text contrast | 3:1 (UI boundaries, focus rings, icons) | WCAG 1.4.11 |
  114. | Feedback latency | < 100ms feels instant; > 1s show a spinner; > 10s show progress with cancel | Nielsen response-time limits |
  115. | Transitions | 150–300ms typical, ≤ 500ms for large motion | Material motion |
  116. | Loading indicator delay | ~300ms before showing, to avoid flashes | |
  117. | Toast | 4–8s auto-dismiss (no actions) | |
  118. | Text expansion | 30–40% (DE/FI/RU), up to 200%+ for short strings | W3C i18n |
  119. | Working memory | ~4±1 chunks (Cowan); 7±2 (Miller) is dated | |
  120. | Canvas | cursor updates 50–100ms, 60fps pan/zoom, 2–8px snap threshold, 10%–4000% zoom | Figma-class tools |
  121. | Avatar stack | 3–5 visible, then "+N" | |
  122. | AI response | first token < 1s, or show immediate progress | |
  123. | Displayed QR code | 4-module quiet zone; module ≥ 0.25 mm physical; error correction M by default | ISO/IEC 18004; IATA BCBP; DENSO WAVE |
  124. | QR size vs. distance | ≥ 2×2 cm, +1 cm per 10 cm of scan distance | NN/g heuristic |
  125. Numbers like conversion rates, NPS targets, and completion percentages depend on context. Don't quote benchmarks as universal facts. Recommend measuring against the product's own baseline.
  126. ## Anti-patterns
  127. Each one points to the reference file that covers the fix.
  128. - Dark patterns, confirmshaming, asymmetric consent → [15](references/15-ethical-design.md)
  129. - Hidden desktop navigation, no sense of location → [05](references/05-information-architecture.md)
  130. - Infinite scroll without position or a footer → [21](references/21-data-tables.md)
  131. - Autoplaying media, color-only signals, invisible focus → [03](references/03-accessibility.md)
  132. - Disabled buttons with no explanation, modal overuse → [06](references/06-interaction-design.md)
  133. - Walls of text, no hierarchy → [04](references/04-visual-design.md)
  134. - Tiny touch targets → [08](references/08-mobile-ux.md)
  135. - Missing loading, empty, or error states → [22](references/22-performance-ux.md)
  136. - Silent sync failures, no offline indication → [12b](references/12b-conflict-resolution-sync.md)
  137. - Cursor overload, no presence → [12a](references/12a-presence-awareness.md)
  138. - Screen-center zoom → [13a](references/13a-canvas-navigation.md)
  139. - Hidden AI, AI changes applied without consent or undo → [14](references/14-ai-ux-patterns.md)
  140. - Mandatory long tours → [16](references/16-onboarding.md)
  141. - Notification carpet bombing, push permission on first visit → [17](references/17-notifications.md)
  142. - Hardcoded strings, fixed widths, LTR-only layout → [23](references/23-internationalization.md)
  143. - Voice-only flows, hidden mic, no recognition feedback → [24](references/24-voice-and-multimodal.md)
  144. - Scan-only flows with no manual entry, silent scan failures → [25a](references/25a-barcode-camera-scanning.md) / [25b](references/25b-barcode-scanner-workflows.md)
  145. - CLI prompts or spinners in pipes/CI, logs on stdout, no `--json` → [26a](references/26a-cli-design.md)
  146. - TUI as the only interface, colour-only focus, terminal left raw after a crash → [26b](references/26b-terminal-output-and-tui.md)
  147. ## Sources
  148. [Laws of UX](https://lawsofux.com/) · [Nielsen Norman Group](https://www.nngroup.com/) · [WCAG 2.2](https://www.w3.org/TR/WCAG22/) · [Material Design](https://m3.material.io/) · [Apple HIG](https://developer.apple.com/design/) · [Baymard Institute](https://baymard.com/) · [Google PAIR](https://pair.withgoogle.com/guidebook) · [Microsoft HAX](https://www.microsoft.com/en-us/haxtoolkit/) · [Deceptive Design](https://www.deceptive.design/) · [EU DSA](https://digital-strategy.ec.europa.eu/en/policies/digital-services-act-package) · [EU Accessibility Act](https://ec.europa.eu/social/main.jsp?catId=1202) · [W3C i18n](https://www.w3.org/International/) · [Liveblocks](https://liveblocks.io/) · [Figma Engineering](https://www.figma.com/blog/category/engineering/) · [Tufte](https://www.edwardtufte.com/) · [ColorBrewer](https://colorbrewer2.org/) · [web.dev](https://web.dev/) · [clig.dev](https://clig.dev/)
README.md · README · 113 lines
  1. # UX Designer Skill
  2. A Claude Code skill that provides comprehensive UX/UI design guidance based on modern best practices (2026).
  3. ## What It Does
  4. Gives Claude deep knowledge of user experience design principles so it can:
  5. - Design new interfaces and components with proper patterns
  6. - Review existing UI/UX and frontend code for issues
  7. - Apply WCAG 2.2 AA accessibility standards
  8. - Guide interaction design, form design, and navigation
  9. - Advise on mobile-first and responsive approaches
  10. - Write effective UI copy and microcopy
  11. - Design collaborative/multiplayer and canvas-based apps
  12. - Build AI-powered interfaces (chat, copilots, agents)
  13. - Evaluate designs for dark patterns and ethical compliance
  14. - Design onboarding, notifications, search, data tables, and dashboards
  15. - Internationalize UI and support right-to-left (RTL) languages
  16. - Design voice and multimodal interactions
  17. - Design barcode/QR scanning (camera and hardware scanners) and code display
  18. - Design CLIs and TUIs (flags, help, output contracts, terminal colour/progress, keybindings, terminal accessibility)
  19. - Check compliance with the European Accessibility Act (EAA)
  20. ## Installation
  21. Clone the repository into your Claude Code skills directory:
  22. ```bash
  23. # Personal (all projects)
  24. git clone https://github.com/szilu/ux-designer-skill.git ~/.claude/skills/ux-designer
  25. # Or project-only
  26. git clone https://github.com/szilu/ux-designer-skill.git .claude/skills/ux-designer
  27. ```
  28. Or download a release archive and extract it to one of those paths. The directory name (`ux-designer`) is the skill name.
  29. The skill is invocable by both user (`/ux-designer`) and Claude (auto-triggered when UX topics arise).
  30. ## Structure
  31. ```
  32. ux-designer/
  33. ├── SKILL.md # Workflows, core rules, routing table
  34. └── references/ # Detailed reference files (each opens with a TOC)
  35. ├── 01-core-principles.md # Nielsen heuristics, Gestalt, visual hierarchy
  36. ├── 02-laws-of-ux.md # Fitts's, Hick's, Miller's, Jakob's, etc.
  37. ├── 03-accessibility.md # WCAG 2.2 AA compliance
  38. ├── 04-visual-design.md # Typography, color, spacing, hierarchy
  39. ├── 05-information-architecture.md # Navigation, sitemaps, card sorting
  40. ├── 06-interaction-design.md # Modals, tooltips, drag-and-drop
  41. ├── 07-forms-and-inputs.md # Validation, field types, error handling
  42. ├── 08-mobile-ux.md # Touch targets, gestures, responsive
  43. ├── 09-ux-writing.md # Microcopy, tone, error messages
  44. ├── 10-user-research.md # Interviews, usability testing, surveys
  45. ├── 11-design-systems.md # Tokens, components, documentation
  46. ├── 12a-presence-awareness.md # Live cursors, avatars, typing indicators
  47. ├── 12b-conflict-resolution-sync.md # OT/CRDTs, locking, offline sync
  48. ├── 13a-canvas-navigation.md # Zoom, pan, selection, manipulation
  49. ├── 13b-canvas-objects-performance.md # Layers, snapping, LOD, culling
  50. ├── 14-ai-ux-patterns.md # Chat UI, copilots, agents, generative UI
  51. ├── 15-ethical-design.md # Dark patterns, consent, GDPR/DSA
  52. ├── 16-onboarding.md # First-run, activation, empty states
  53. ├── 17-notifications.md # Toasts, badges, push, attention management
  54. ├── 18-data-visualization.md # Charts, dashboards, KPIs
  55. ├── 19-search-ux.md # Autocomplete, filters, results ranking
  56. ├── 20-emotional-design.md # Trust, delight, brand personality
  57. ├── 21-data-tables.md # Sorting, pagination, bulk actions, inline edit
  58. ├── 22-performance-ux.md # Skeletons, optimistic updates, CLS, lazy loading
  59. ├── 23-internationalization.md # i18n, RTL, Intl formatting, plurals
  60. ├── 24-voice-and-multimodal.md # Voice, multimodal, cross-device input
  61. ├── 25a-barcode-camera-scanning.md # Camera scanning on phone/web, QR safety
  62. ├── 25b-barcode-scanner-workflows.md # Scan-driven apps, wedge scanners, GS1 primer
  63. ├── 25c-barcode-display.md # Showing codes on screens, wallet passes, print
  64. ├── 26a-cli-design.md # Commands, flags, help, streams, exit codes, agent CLIs
  65. └── 26b-terminal-output-and-tui.md # Colour, progress, terminal a11y, TUI layout/keys/rendering
  66. ```
  67. ## SKILL.md Highlights
  68. The main file (loaded when the skill triggers) includes:
  69. - **Workflows** for reviewing/auditing a UI (render, extremes, severity-ranked findings) and for building UI (reuse, all states, semantics, verify)
  70. - **Generated-UI defaults to avoid** (common model-generated aesthetic tells)
  71. - **Core rules** per domain, and **decision trees** for modal/panel/page and notification types
  72. - **Reference values** with sources, a **routing table** saying when to load each reference file, and anti-patterns linked to their fixes
  73. Reference files are loaded on demand when the topic is relevant, keeping context usage efficient.
  74. ## Coverage Areas
  75. | Domain | References |
  76. |--------|-----------|
  77. | Foundations | Core principles, Laws of UX, accessibility, visual design |
  78. | Structure | Information architecture, interaction design, forms |
  79. | Platform | Mobile UX, design systems |
  80. | Content | UX writing, user research |
  81. | Collaboration | Presence/awareness, conflict resolution/sync |
  82. | Canvas/Spatial | Navigation/interaction, objects/performance |
  83. | Modern | AI interfaces, ethical design, emotional design |
  84. | Flows | Onboarding, notifications, search |
  85. | Data | Data visualization, data tables, performance/loading |
  86. | Global & Input | Internationalization/RTL, voice and multimodal, barcode scanning & display |
  87. | Terminal | CLI design, terminal output & TUIs |
  88. ## Sources
  89. The skill synthesizes guidance from sources including Nielsen Norman Group, WCAG 2.2, Material Design, Apple HIG, Laws of UX, Google PAIR, Microsoft HAX Toolkit, Baymard Institute, The A11y Project, and web.dev.
  90. ## License
  91. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.