跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

semantic-html-first

Choose HTML semantics and accessible behavior for controls, forms, and custom interaction primitives.

kemiljk · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add kemiljk/skills --skill semantic-html-first

技能说明


name: semantic-html-first description: "Choose HTML semantics and accessible behavior for controls, forms, and custom interaction primitives." license: MIT

Semantic HTML First

Semantic HTML is interface infrastructure. Native elements carry keyboard support, form participation, disabled behaviour, and accessibility semantics without a second implementation.

Defaults

  1. Start with the native element that matches the interaction.
  2. Use ARIA to refine native semantics, not to rebuild them on div/span.
  3. Prefer explicit composition over magic asChild polymorphism when it obscures the real element.
  4. Style states with native pseudo-classes (:disabled, :checked, :open, :invalid) before parallel data-* state systems.
  5. If a library primitive exists, verify it still renders a real semantic element in the DOM.

Prefer / Reject

PreferReject
<button type="button"><div onClick> / <span role="button"> without need
<a href> for navigationButton-styled divs that only route in JS
<details> / <summary>Custom disclosure with ad-hoc keyboard code
<dialog> / Popover APIModal divs fighting focus and top-layer behaviour
Native <form> controlsClickable rows that ignore Enter/Space/disabled

Decision guide

  • Performs an action: button
  • Goes somewhere: a[href]
  • Toggles visibility of related content: details or disclosure button + controlled region
  • Requires a temporary overlay task: dialog or popover
  • Collects input: native form controls inside form

Review checklist

  • Can this be a native element?
  • Tab focus works without extra code?
  • Enter/Space activate buttons?
  • Disabled state blocks interaction and exposure correctly?
  • Screen reader role matches the visual control?
  • Form controls submit/reset with the form?
  • Custom ARIA is additive, not a rewrite of the platform?

Source essays

  • On the semantic web
  • Why I built a semantic-HTML first library