# Design Accessibility

> WCAG and ARIA best practices for web UIs. Extends platform-frontend with accessibility-specific rules. Use when building any user-facing interface.

- Skill: `majiayu000/design-accessibility` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/design-accessibility`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/design-accessibility/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/majiayu000/design-accessibility

---


# Principles

- Use semantic HTML first — ARIA is a last resort, not a first tool
- Proper heading hierarchy — one h1 per page, never skip levels
- Alt text on all meaningful images
- Maintain 4.5:1 minimum color contrast ratio
- Use `<button>` for actions, `<a>` for navigation — never a styled `<div>`

# Rules

See `rules/` for detailed patterns.