semantic-markup-contracts
Semantic markup contracts
Use this skill when the question is which HTML structure should exist before styling, scripting, or ARIA patches — structure that browsers, assistive technology, crawlers, forms, and tests can all rely on. Prefer the native element whose built-in contract already matches the user action; add ARIA only when native HTML cannot express the pattern, then test the rendered contract.
Boundary with sibling skills
This skill owns element choice and document structure (buttons vs links,
headings, landmarks, labels, tables, lists, nesting, native
disclosure/dialog/form semantics). a11y-contract-testing owns rendered
role/name/state/focus tests (getByRole, keyboard paths, ARIA state);
constraint-validation-contracts owns the native validity lifecycle;
design-to-code-fidelity owns visual spacing/ordering drift a semantic fix may
cause.