AgentSkillsCN

accessibility-checklist

在设计API、创建新端点,或与后端架构师共同审视API结构时,遵循RESTful与API设计的最佳实践,包括端点设计、错误处理、数据校验与版本控制等方面。

SKILL.md
--- frontmatter
name: accessibility-checklist
description: Verify WCAG 2.1 AA compliance for UI components. Use when building or reviewing frontend components, implementing accessibility, or working with frontend-architect.

Accessibility Checklist

Quick Checks

Semantic HTML

  • Use <button> for actions, <a> for navigation
  • Use headings in order (h1 → h2 → h3)
  • Use <label> for form inputs; associate with htmlFor/id
  • Use <main>, <nav>, <aside>, <footer> for landmarks

Keyboard

  • All interactive elements focusable (no tabIndex="-1" on controls)
  • Focus order is logical
  • Focus visible (outline or custom ring)
  • Escape closes modals/dropdowns
  • No keyboard traps

Screen Readers

  • Images have alt (empty alt="" for decorative)
  • Form errors announced (aria-live or role="alert")
  • Dynamic content changes announced
  • Use aria-label or aria-labelledby when visible label insufficient

Color & Contrast

  • Text contrast ≥ 4.5:1 (normal), ≥ 3:1 (large)
  • Don't rely on color alone for information
  • Focus indicators visible

Forms

  • Required fields indicated (aria-required, visual)
  • Error messages linked to fields (aria-describedby)
  • Clear, inline validation feedback

Testing

  • Navigate with keyboard only
  • Test with screen reader (VoiceOver, NVDA)
  • Use axe DevTools or Lighthouse accessibility audit