SKILL.md
Reader UI/UX
Purpose: deliver intentional, localized, accessible reader/admin UX.
When to Use
- Modifying reader/admin React screens, layout primitives, or shared UI components.
- Adding localization copy, accessibility improvements, or design polish.
- Building locale switchers, typography controls, or comment/annotation panels.
Workflow
- Define experience -- confirm viewport-specific layout (mobile drawer vs desktop side panels) + theme rules.
- Localization -- add strings to locale catalogs, ensure fallback, surface locale switcher.
- Accessibility -- keyboard focus, ARIA labels, reduced motion, semantic regions.
- State -- use state management selectors, avoid prop drilling, memoize heavy renders.
- Observability -- log key UI actions with trace IDs.
- Testing -- add component tests; E2E coverage for primary flows.
Checklist
- Layout responsive (mobile/tablet/desktop) with deliberate spacing.
- Strings localized and locale header updated.
- Error states use ErrorBoundary + inline alerts.
- Async effects cancel via AbortController; cleanup functions implemented.
- UI interactions include aria-labels + focus traps where applicable.
See Also
anti-ai-slop— Avoid AI slop in UI/UXcss-render-performance— CSS render performance optimization
Rationalizations
| Rationalization | Reality |
|---|---|
| "Accessibility is a nice-to-have, not a requirement" | Legal compliance (WCAG, ADA, Section 508) and user inclusion make it mandatory. |
| "I'll add localization later after the UI is done" | Retroactive localization is costly; string extraction and fallback logic should be designed upfront. |
| "Prop drilling is simpler than state management" | Prop drilling breaks at scale; memoized selectors prevent unnecessary re-renders and deep coupling. |
Red Flags
- Reader UI built without keyboard navigation support
- Locale strings hardcoded in components instead of catalog
- Missing ErrorBoundary or AbortController cleanup on async effects
References
references/responsive-patterns.md- Responsive layout patternsreferences/accessibility-checklist.md- WCAG compliance checklist
Voice & Context
- Default:
professional+blog - Reference:
voice-profilesskill for definitions and auto-detection.