--- name: coordinator description: 'Triage router for the ui-excellence plugin. Analyzes task context and routes to the right specialist skill(s) — often multiple at once. Use when building, reviewing, or refining any web UI: components, pages, layouts, forms, modals, animations, styles, audits, copywriting, or engagement design.' paths: - "*.tsx" - "*.jsx" - "*.vue" - "*.svelte" - "*.html" - "*.css" - "*.scss" - "src/components/**/*" - "src/pages/**/*" - "src/layouts/**/*" - "src/styles/**/*" --- # UI Excellence — Coordinator ## Overview This skill is a **triage router** that coordinates twelve specialized UI skills organized in five groups. When invoked, it analyzes what you are working on and automatically loads the relevant skill(s) — often multiple at once. > "Great interfaces rarely come from a single thing. It's usually a collection of small things that compound into a great experience." ## Skills Catalog ### Foundations (original) | Skill | Invoke | Domain | |-------|--------|--------| | `animation-motion` | `/ui-excellence:animation-motion` | Easing, springs, gestures, transitions, performance, `prefers-reduced-motion` | | `visual-polish` | `/ui-excellence:visual-polish` | Text wrapping, border radius, shadows, font smoothing, tabular nums, optical alignment | | `web-standards` | `/ui-excellence:web-standards` | Accessibility, forms, focus states, typography, content handling, images, perf, dark mode, i18n | | `accessibility` | `/ui-excellence:accessibility` | Semantic HTML, keyboard navigation, ARIA, color contrast, screen readers, WCAG 2.1 AA | ### Systems (macro-design) | Skill | Invoke | Domain | |-------|--------|--------| | `refactoring` | `/ui-excellence:refactoring` | Visual hierarchy, spacing scales, color palettes, depth/shadows, design tokens, grayscale-first workflow | | `typography` | `/ui-excellence:typography` | Typeface selection, font pairing, responsive type, web font loading, FOUT/FOIT, typographic scales | ### Audit (evaluation) | Skill | Invoke | Domain | |-------|--------|--------| | `heuristics` | `/ui-excellence:heuristics` | Nielsen's 10 heuristics, Krug usability, severity ratings, cognitive walkthrough, information architecture | | `cro` | `/ui-excellence:cro` | Conversion rate optimization, funnel mapping, A/B testing, objection handling, persuasion assets | ### Interaction (micro-details) | Skill | Invoke | Domain | |-------|--------|--------| | `microinteractions` | `/ui-excellence:microinteractions` | Triggers, rules, feedback, loops & modes, loading states, state transitions, input feedback | ### Behavior (engagement) | Skill | Invoke | Domain | |-------|--------|--------| | `hooked` | `/ui-excellence:hooked` | Hook Model (Trigger→Action→Variable Reward→Investment), habit formation, ethics evaluation | | `retention` | `/ui-excellence:retention` | Behavior design (B=MAP), Ability Chain, activation milestones, onboarding friction, tiny habits | | `copy` | `/ui-excellence:copy` | SUCCESs checklist (Simple, Unexpected, Concrete, Credible, Emotional, Stories), sticky messaging | ## Triage Logic When this skill is invoked, follow this decision process: ``` START: What is the task? │ ├── Full UI audit / review? │ └── YES → Apply foundations (all 4) + heuristics + refactoring │ ├── Landing page / conversion / "why visitors leave"? │ └── YES → Apply cro + heuristics + copy │ ├── Onboarding / activation / "users drop off"? │ └── YES → Apply retention + hooked + heuristics │ ├── New component build (modal, form, dropdown, tabs)? │ └── YES → Apply web-standards + accessibility + animation-motion + microinteractions │ ├── Design system / tokens / color / spacing? │ └── YES → Apply refactoring + visual-polish + typography │ ├── Typography / fonts / readability? │ └── YES → Apply typography + web-standards (type section) │ ├── Animation / transition / motion? │ └── YES → Apply animation-motion + microinteractions │ ├── Accessibility / WCAG / keyboard / ARIA? │ └── YES → Apply accessibility + web-standards (a11y section) │ ├── Polish / refinement / "make it feel better"? │ └── YES → Apply visual-polish + microinteractions │ ├── Messaging / copy / "make it memorable"? │ └── YES → Apply copy + cro (copywriting section) │ ├── Engagement / "users aren't coming back"? │ └── YES → Apply hooked + retention │ └── General / unsure └── Apply web-standards + visual-polish (safe defaults) ``` ## Signal-Based Routing When triaging, look for these signals in the task and files: ### Route to `animation-motion` when: - Files contain `transition`, `animation`, `@keyframes`, `transform`, spring config - Task mentions: animate, motion, easing, gesture, drag, spring, entrance/exit - Working with: modals, drawers, toasts, tooltips, popovers, dropdowns (animation aspect) - CSS includes: `transition-*`, `animation-*`, `will-change`, `@starting-style` ### Route to `visual-polish` when: - Task is about refining/polishing existing UI - Files contain: `border-radius`, `box-shadow`, `font-variant-numeric`, `text-wrap` - Working with: spacing, shadows, alignment, text rendering, number displays - Focus is on "make it feel better" rather than adding new functionality ### Route to `web-standards` when: - Building or reviewing any web component or page - Files are `.tsx`, `.jsx`, `.html`, `.css`, `.scss`, or Tailwind configs - Task involves: forms, images, performance, dark mode, i18n, navigation, state management - Code review or audit requested ### Route to `accessibility` when: - Task mentions: accessibility, a11y, WCAG, screen reader, keyboard navigation - Building interactive components: dropdowns, modals, tabs, forms - Files contain: `aria-*`, `role=`, `tabindex`, `