web-interface-conventions
Installation
SKILL.md
Web interface conventions
This skill owns framework-independent interface behavior and presentation. Framework skills own framework APIs and component mechanics.
Prepare the work
- Inspect the task, approved design references, and the existing project UI before making visible decisions.
- Identify the affected user journeys, states, transitions, content extremes, viewports, themes, and input methods. Cover only the variants that the task can change.
- Read the references that match the task before making the affected decisions:
- design sources for visual direction, copy, assets, shared components, or localization;
- visual hierarchy and content for page priority, grouping, copy density, disclosure, color accents, icons, or graphics;
- semantics and accessibility for document structure, page titles, landmarks, reading order, or native HTML meaning;
- styling foundations for CSS, browser support, resets, tokens, themes, selectors, or custom properties;
- responsive layout for page or component layout, queries, intrinsic sizing, breakpoints, or overflow;
- forms for fields, validation, authentication, selection, or file input;
- interaction states for controls, focus, feedback, dialogs, icons, or visual states;
- async feedback for network work, loading, retry, cancellation, or third-party UI.
- Ask the user when a visible product decision remains unclear and the available sources do not settle it. Continue work that does not depend on that choice.