a11y-audit (웹 접근성 감사)
React·Vue·Angular·Svelte·HTML 코드베이스를 WCAG 2.2 A/AA 기준으로 진단하고 프레임워크별 수정 코드까지 만들어 주는 접근성 감사 스킬.
개발·코딩중급★ 24,151⑂ 3,405AI 점수 9/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
웹 접근성(a11y)을 스캔 → 수정 → 검증 3단계로 처리하는 감사 파이프라인입니다.
- 코드베이스 전체를 훑어 WCAG 2.2 Level A/AA 위반을 찾아내고 Critical / Major / Minor 로 등급 분류
- 프로젝트의 프레임워크(React, Next.js, Vue, Angular, Svelte, 순수 HTML)를 자동 감지해 그에 맞는 before/after 수정 코드 제시
contrast_checker.py로 전경/배경 색상 대비율을 AA·AAA 기준으로 검사하고 대체 색상 제안- 키보드 내비게이션, 포커스 관리, ARIA 속성 오용 점검
- 개발자·PM·컴플라이언스 담당자가 바로 볼 수 있는 감사 리포트 생성
- GitHub Actions / GitLab CI / Azure DevOps 파이프라인에 붙여 회귀 방지
이런 분께 추천
- 공공기관·금융·교육 서비스처럼 접근성 준수가 법적 요구사항인 프로젝트를 맡은 프론트엔드 개발자
- 디자인 시스템의 색상 팔레트가 대비 기준을 통과하는지 확인해야 하는 UI 엔지니어
- 코드 리뷰나 CI에 접근성 게이트를 추가하고 싶은 팀 리드
- 접근성 개선 결과를 이해관계자에게 보고해야 하는 QA·PM
활용 예시
- 릴리스 전 전수 점검 —
"/a11y-audit --scope src/ --report"를 실행해 Critical 위반 목록과 스테이크홀더용 리포트를 한 번에 받습니다. - 컴포넌트 리팩터링 —
<div onClick>로 만든 상품 카드를 붙여넣으면 키보드 접근 불가, alt 누락, 대비 미달을 짚어내고<a>+aria-label+ 접근 가능한 색상으로 고친 코드를 돌려줍니다. - CI 회귀 방지 — 기준선(baseline) JSON을 저장한 뒤 PR마다
--ci모드로 실행해 새 Critical 이슈가 생기면 빌드를 실패시킵니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 alirezarezvani/claude-skills 의 .gemini/skills/a11y-audit 폴더를 내 ~/.claude/skills/a11y-audit/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/alirezarezvani/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/.gemini/skills/a11y-audit ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 내려받습니다.
git clone https://github.com/alirezarezvani/claude-skills.git - Claude Code 스킬 폴더를 준비합니다.
mkdir -p ~/.claude/skills - a11y-audit 스킬만 복사합니다.
cp -r claude-skills/.gemini/skills/a11y-audit ~/.claude/skills/ - 파일이 잘 들어갔는지 확인합니다.
ls ~/.claude/skills/a11y-audit에SKILL.md,scripts/,references/가 보이면 성공입니다. - 스캐너 실행에 Python 3가 필요합니다.
python3 --version으로 설치 여부를 확인하세요. - Claude Code를 재시작한 뒤 프로젝트 폴더에서 "이 프로젝트 접근성 감사해줘" 또는
/a11y-audit라고 입력하면 스킬이 동작합니다.
GitHub에서 원본 보기 ↗라이선스: MIT