사용 가이드로 건너뛰기
Accessibility Audit작성자 Alireza Rezvani

Accessibility Audit 스킬.

각 접근성 발견 사항을 영향받는 요소, 제안된 수정, 검증 결과와 연결해 관리하세요.

  • 접근성
  • 디자인 검토
  • 프런트엔드
소스 검토 · Accessibility AuditSKILL.md
작업 접근성 산출물 • 심각도 순으로 정리한 접근성 발견 사항 보고서 • 프로젝트 프레임워크에 맞는 수정 전후 코드 • 최초 발견 사항과의 비교 및 남은 수동 점검 목록 시작하기 전에 번들 도구용 Python, 소스 접근 권한, 맥락 기반 검증을 위한 브라우저 또는 보조 기술 환경이 필요합니다.
편집 요약 · 검토한 소스 2026-10-07 · 생성된 예시 아님

01 기능 소개

접근성 발견 사항을 검증 가능한 수정으로 바꾸세요

Python 유틸리티, 프레임워크 참고 자료, 보고서 템플릿을 갖춘 스캔-수정-검증 접근성 워크플로입니다.

소스 기반 워크플로실행 벤치마크 아님

작업 방식

A11y Audit은 접근성 작업을 스캔, 수정, 검증 단계로 나눕니다. 소스에는 Python 스캐너와 명도 대비 검사기 인터페이스, 심각도 범주, 프레임워크별 수정 참고 자료가 포함되어 있습니다. 접근성을 개선해 달라는 막연한 요청을 범위가 정해진 요소 목록과 코드 변경으로 구체화하는 데 도움이 됩니다.

소스는 폭넓은 WCAG 범위를 설명하지만, 코드 스캔을 완전한 적합성 인증처럼 제시해서는 안 됩니다. 키보드 흐름, 스크린 리더 동작, 동적 콘텐츠, 대체 텍스트의 유용성은 여전히 맥락에 따른 검토가 필요합니다. 실질적 가치는 추적 가능성에 있습니다. 최초 발견 사항을 보존하고, 적절한 네이티브 시맨틱이나 스타일 변경을 적용한 뒤, 검사를 다시 실행하고 실제 상호작용을 테스트하세요.

예상 산출물

  • 심각도 순으로 정리한 접근성 발견 사항 보고서
  • 프로젝트 프레임워크에 맞는 수정 전후 코드
  • 최초 발견 사항과의 비교 및 남은 수동 점검 목록
예시 브리프 보기

브리프에서 검토까지

  1. 01
    정해진 범위 스캔

    프레임워크와 관련 소스 경로를 파악하세요. 요소 단위로 발견 사항을 기록하고 스캐너 탐지와 수동 관찰을 구분하세요.

  2. 02
    근본적인 상호작용 수정

    ARIA 속성을 무분별하게 추가하기보다 네이티브 컨트롤, 의미 있는 레이블, 눈에 보이는 포커스를 우선하세요.

  3. 03
    맥락 안에서 검증

    기준선과 비교하고, 렌더링된 상태에서 명도 대비를 확인하며, 정적 분석으로 확인할 수 없는 키보드 및 보조 기술 경로를 직접 시험하세요.

02 활용 상황

사용 시기

번들 도구용 Python, 소스 접근 권한, 맥락 기반 검증을 위한 브라우저 또는 보조 기술 환경이 필요합니다.

적합한 경우

  • 수정 계획소스 수준의 여러 문제를 우선순위가 매겨진, 검토 가능한 코드 변경으로 바꾸는 데 유용합니다.
  • 회귀 점검기존 테스트 프로세스에 반복 가능한 접근성 검사를 추가하는 프로젝트에 맞습니다.

확인할 한계

  • 준수 인증서 아님포함된 도구를 통과했다고 해서 제품 전반에 적용되는 모든 접근성 요구사항을 충족한다는 증거가 되지는 않습니다.
  • 심각도는 맥락이 필요합니다소스의 심각도 레이블은 분류를 돕는 보조 수단입니다. 실제 사용자 영향은 요소, 작업, 사용 가능한 대안에 따라 달라집니다.

준비할 입력

  • 감사 범위검토할 페이지, 컴포넌트 또는 소스 디렉터리와 사용자 여정을 명시하세요.
  • 렌더링된 상태단순한 정적 페이지에는 없는 폼, 오류, 대화상자 등 여러 상태에 접근할 수 있게 해 주세요.
  • 기존 기준선해결된 문제와 회귀를 구분할 수 있도록 이전 발견 사항이나 테스트 결과를 포함하세요.

03 핵심 결정

중요한 결정

  1. 수정을 추적할 수 있음

    수정 전후 예시는 표준 참조만 남기는 대신 발견 사항을 구체적인 구현과 연결합니다.

  2. 자동화에는 한계가 있습니다

    유용한 보고서는 무엇을 스캔했고, 무엇을 수동으로 테스트했으며, 무엇이 검증되지 않았는지 명시합니다.

04 예시 브리프

집중 브리프로 시작하기

아래 예시 브리프는 테스트되지 않았습니다. 사용하기 전에 스킬의 설정을 확인하세요.

설정 검토

스크립트와 참고 패턴을 유지하세요. 스캐너 결과를 릴리스 게이트로 쓰기 전에 스캐너의 검사 범위를 검토하세요.

업스트림 소스 파일
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md

번들 도구용 Python, 소스 접근 권한, 맥락 기반 검증을 위한 브라우저 또는 보조 기술 환경이 필요합니다.

하나의 산출물로 시작

스킬을 실행하기 전에 이 브리프의 범위, 소스 자료, 제약 조건을 상황에 맞게 조정하세요.

예시 브리프
a11y-audit을 사용해 결제 폼과 모달을 검토하세요. 먼저 영향받는 요소와 심각도 판단 근거를 포함한 읽기 전용 발견 사항 보고서부터 작성하세요. 레이블, 네이티브 컨트롤, 포커스 가시성, 명도 대비를 확인한 뒤 수동 키보드 및 스크린 리더 점검 목록을 정리하세요. 스캐너 결과만으로 페이지가 WCAG를 준수한다고 말하지 말고, 제가 승인하기 전에는 수정을 적용하지 마세요.

결과 점검

실제 출력을 다음의 관찰 가능한 기준과 대조해 확인하세요.

  • 각 발견 사항은 실제 요소와 실행 가능한 수정 방안을 짚어냅니다.
  • 해결된 문제는 최초 기준선과 대조해 다시 확인합니다.
  • 테스트하지 않은 키보드, 스크린 리더, 동적 상태 동작은 검증되지 않았다고 명시적으로 남깁니다.

OpenDesign은 코딩 에이전트를 위한 로컬 디자인 작업 공간을 제공합니다. 이 목록이 해당 스킬이 번들로 포함되어 있다거나 외부 도구, 자격 증명, 소프트웨어 의존성이 포함된다는 뜻은 아닙니다.

05 출처 및 라이선스

소스 및 라이선스

이 페이지는 아래에 링크된 고정 소스 리비전을 설명합니다. 업스트림의 동작과 요구사항은 바뀔 수 있습니다.

소스 소유자
Alireza Rezvani
라이선스
MIT
검토한 스냅샷
2026-10-07 · 19392f7a0826
편집 소스 요약
Python 유틸리티, 프레임워크 참고 자료, 보고서 템플릿을 갖춘 스캔-수정-검증 접근성 워크플로입니다.

링크된 소스를 바탕으로 OpenDesign이 작성한 원본 요약입니다. 저장소 스타 수는 날짜 기준의 인기 지표일 뿐 스킬 사용량이나 품질 점수가 아닙니다.

06 시작 전 질문

시작 전 질문

스캐너가 WCAG 적합성을 증명할 수 있나요?

아니요. 이 스킬은 감사를 지원할 수 있지만, 자동화된 소스 검사는 모든 맥락적 요구사항이나 상호작용 요구사항을 다루지 않습니다.

React만 지원하나요?

소스에는 여러 웹 프레임워크와 순수 HTML용 패턴이 포함되어 있습니다. 프로젝트 버전에 대한 실제 스캐너 및 참고 자료 지원 여부는 직접 확인하세요.

클릭 가능한 모든 요소에 ARIA 역할을 부여해야 하나요?

자동으로 그럴 필요는 없습니다. 소스는 대체로 네이티브 시맨틱 컨트롤을 선호하며, 이는 ARIA 역할만으로는 추가되지 않는 동작을 제공합니다.

OpenDesign

다음 디자인 반복을 위한 공간을 확보하세요.

브리프, 소스 자료, 디자인 작업을 로컬 작업 공간에 함께 보관하세요. 워크플로에 추가하기 전에 스킬 자체의 설정을 확인하세요.

업스트림 소스 파일
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md