$npx -y skills add jgamaraalv/ts-dev-kit --skill ui-ux-guidelinesReview UI code for Web Interface Guidelines compliance. Use when asked to review UI, check accessibility, audit design, review UX, or check against best practices.
| 1 | # Web Interface Guidelines |
| 2 | |
| 3 | Dispatch hub for UI/UX rules. Load the relevant reference file for full details. |
| 4 | |
| 5 | <rules> |
| 6 | |
| 7 | ## Rule Categories by Priority |
| 8 | |
| 9 | | Priority | Category | Impact | Reference File | |
| 10 | | -------- | -------------------- | -------- | ------------------------------- | |
| 11 | | 1 | Accessibility | CRITICAL | `accessibility-and-interaction` | |
| 12 | | 2 | Touch & Interaction | CRITICAL | `accessibility-and-interaction` | |
| 13 | | 3 | Performance | HIGH | `layout-typography-animation` | |
| 14 | | 4 | Layout & Responsive | HIGH | `layout-typography-animation` | |
| 15 | | 5 | Typography & Color | MEDIUM | `layout-typography-animation` | |
| 16 | | 6 | Animation | MEDIUM | `layout-typography-animation` | |
| 17 | | 7 | Forms | HIGH | `forms-content-checklist` | |
| 18 | | 8 | Content & Navigation | MEDIUM | `forms-content-checklist` | |
| 19 | | 9 | Charts & Data | LOW | `layout-typography-animation` | |
| 20 | |
| 21 | </rules> |
| 22 | |
| 23 | <workflow> |
| 24 | |
| 25 | ## Workflows |
| 26 | |
| 27 | <phase_1_review_ui> |
| 28 | ### Review UI code |
| 29 | |
| 30 | 1. Read the target file(s). |
| 31 | 2. Load the relevant reference file(s) from `references/` based on what the code contains. |
| 32 | 3. Check each applicable rule. Report violations in the output format below. |
| 33 | </phase_1_review_ui> |
| 34 | |
| 35 | <phase_2_build_component> |
| 36 | ### Build new component |
| 37 | |
| 38 | 1. Load `references/accessibility-and-interaction.md` -- all components must meet CRITICAL rules. |
| 39 | 2. Load additional references based on component type: |
| 40 | - Form component -> `references/forms-content-checklist.md` |
| 41 | - Layout/visual component -> `references/layout-typography-animation.md` |
| 42 | 3. Follow rules during implementation. |
| 43 | </phase_2_build_component> |
| 44 | |
| 45 | <phase_3_pre_delivery> |
| 46 | ### Pre-delivery checklist |
| 47 | |
| 48 | 1. Load `references/forms-content-checklist.md` for the full checklist. |
| 49 | 2. Load `references/accessibility-and-interaction.md` for the interaction checklist. |
| 50 | 3. Walk through every checkbox before shipping. |
| 51 | </phase_3_pre_delivery> |
| 52 | |
| 53 | </workflow> |
| 54 | |
| 55 | <anti_patterns> |
| 56 | |
| 57 | ## Anti-patterns (flag these) |
| 58 | |
| 59 | - `user-scalable=no` or `maximum-scale=1` -- disables zoom |
| 60 | - `onPaste` with `preventDefault` -- blocks paste |
| 61 | - `transition: all` -- list properties explicitly |
| 62 | - `outline-none` without `:focus-visible` replacement |
| 63 | - `<div>`/`<span>` with click handlers -- use `<button>` or `<a>` |
| 64 | - `<img>` without `width` and `height` (causes CLS) |
| 65 | - Inline `onClick` navigation without `<a>` (breaks Cmd+click) |
| 66 | - Large `.map()` without virtualization (>50 items) |
| 67 | - Hardcoded date/number formats -- use `Intl.*` |
| 68 | - Icon-only buttons without `aria-label` |
| 69 | |
| 70 | </anti_patterns> |
| 71 | |
| 72 | <output> |
| 73 | |
| 74 | ## Code Review Output Format |
| 75 | |
| 76 | Group findings by file. Use `file:line` format (VS Code clickable). Be terse -- state issue and location. Skip explanation unless fix is non-obvious. |
| 77 | |
| 78 | See [template.md](template.md) for the expected output format. |
| 79 | |
| 80 | </output> |
| 81 | |
| 82 | <references> |
| 83 | |
| 84 | ## Reference Files |
| 85 | |
| 86 | Load these as needed during reviews and implementation: |
| 87 | |
| 88 | - **[Accessibility & Interaction](references/accessibility-and-interaction.md)** -- Focus, ARIA, keyboard, touch targets, cursors, drag UX |
| 89 | - **[Layout, Typography & Animation](references/layout-typography-animation.md)** -- Performance, responsive, fonts, color, motion, charts |
| 90 | - **[Forms, Content & Checklist](references/forms-content-checklist.md)** -- Forms, content handling, navigation, dark mode, locale, hydration, pre-delivery checklist |
| 91 | |
| 92 | </references> |