접근성 감사 (a11y-audit)
UI를 WCAG 2.2 AA/AAA와 ARIA 패턴 기준으로 점검해 기준번호·심각도·수정안이 담긴 감사표를 만들어 주는 스킬.
디자인·UI중급★ 3,146⑂ 303AI 점수 8/10마지막 업데이트: 2026. 10. 27.
무엇을 해주나
- UI/디자인을 WCAG 2.2 AA/AAA와 프로젝트의 ARIA 패턴에 대조해 감사합니다.
- 컴포넌트별 필수 P0 항목(키보드 이동, 포커스 가시성 3:1 이상, 스크린리더 name/role/state, 텍스트 4.5:1 · UI 3:1 대비, 24×24 타깃 크기, 색상 단독 신호 금지)을 확인합니다.
- WCAG 2.2 신규 기준(2.4.11 Focus Not Obscured, 2.5.8 Target Size, 3.3.8 Accessible Authentication)을 추가 검증합니다.
- 대비는 눈대중 금지 —
gate.mjs measure_render.mjs,verify_states.mjs,contrast.py로 실제 측정값만 보고하게 합니다. - 결과는
WCAG 기준 · 심각도(P0/P1/P2) · 실패 내용 · 구체적 수정안표로 출력됩니다.
이런 분께 추천
- 접근성 점검이 필요한 프론트엔드 개발자, UI/UX 디자이너, QA
- 디자인 시스템 컴포넌트의 접근성 합격 여부를 증빙해야 하는 팀
- 명세 기반(기준번호 포함) 리포트가 필요한 공공·금융 등 규제 환경
활용 예시
- "이 모달 컴포넌트가 POUR를 만족하는지 감사해줘" → 키보드 트랩·포커스 반환·라벨 누락을 P0로 지적.
- "dashboard.html 다크 모드 대비를 검증해줘" →
measure_render.mjs <file> --dark실행 후 실제 비율 보고. - "버튼 hover/focus 상태 대비가 괜찮은지 확인" →
verify_states.mjs로 상태별 실패를 잡아냄.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/plugin87/ux-ui-agent-skills/HEAD/.claude/skills/a11y-audit/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 plugin87/ux-ui-agent-skills 의 .claude/skills/a11y-audit 폴더를 내 ~/.claude/skills/plugin87-a11y-audit/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/plugin87/ux-ui-agent-skills.git && mkdir -p ~/.claude/skills && cp -r ux-ui-agent-skills/.claude/skills/* ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 작업 폴더로 이동합니다.
- 저장소를 받습니다:
git clone https://github.com/plugin87/ux-ui-agent-skills.git - 이 스킬은 저장소의
tokens/,accessibility/,scripts/등 '키트' 파일을 읽습니다. 스킬 폴더만 복사하면 동작하지 않으니 저장소 전체를 유지하세요. - 가장 쉬운 방법: 저장소 폴더에서
npx ux-ui-agent-skills init를 실행하거나 플러그인 방식으로 설치합니다. - 수동 설치 시:
mkdir -p ~/.claude/skills && cp -r ux-ui-agent-skills/.claude/skills/* ~/.claude/skills/로 복사한 뒤, 키트 폴더도 동일한 상대 경로에 함께 두어야 합니다. - Node.js와 Python3가 설치되어 있는지 확인합니다(
node -v,python3 -V). - Claude Code를 재시작하고 "이 페이지 접근성 감사해줘"처럼 요청하면 스킬이 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT