semantic-markup-css
Installation
SKILL.md
Semantic markup & modern CSS
Load first on marketing UI, layout refactors, or any task touching TSX + styles. Pair with react-client-expert for client state; this skill owns HTML, ARIA, tokens, and CSS architecture.
devprofile overlay: references/devprofile-marketing-css.md
Decision order (always)
- Native element — can
<button>,<a>,<dialog>,<details>,<address>,<figure>,<ul>/<ol>do the job? - Semantics + one heading level — correct landmark/section/article; single
h1, sectionh2, cardh3 - WAI-ARIA only to fill gaps — prefer native semantics; don't duplicate what HTML already exposes
data-*state in DOM — style with CSS; avoid parallelisOpen && "block"class soup- Token/contrast fix — adjust CSS variables before per-component color hacks
- Tailwind for layout/type — spacing, grid, responsive; CSS for scroll-margin,
:has(),@container,color-mix, reduced motion