사용 가이드로 건너뛰기
fixing-accessibility작성자 Julien Thibeaut

Fixing Accessibility 스킬.

디자인 리뷰를 위한 Claude Code 및 Codex skill: ARIA, 키보드, 포커스, 대비 및 폼 오류를 감사하고 수정합니다.

  • Design Review & Accessibility
  • 리뷰 리포트
ibelick/ui-skills · skills/fixing-accessibility/SKILL.mdSKILL.md
--- name: fixing-accessibility description: Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors. Use when adding interactive controls, forms, dialogs, or reviewing WCAG compliance. --- ## how to use ## when to apply ## rule categories by priority ## common fixes ## review guidance
2026-09-14에 업스트림 파일에서 읽은 머리말 및 섹션 제목 · 전체 4,714자

01 기능

Claude Code와 Codex에서 fixing-accessibility 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

코딩 에이전트에서 인터랙티브 UI를 추가하거나 검토하는 디자이너와 개발자를 위한 HTML 접근성 참조 및 수정 규칙 세트입니다. 아홉 가지 규칙 범주를 우선순위와 영향도에 따라 정렬하며, critical 단계의 접근 가능한 이름, 키보드 접근, 포커스와 다이얼로그, 도구 경계부터 시맨틱, 폼과 오류, 알림, 대비와 상태, 그리고 마지막으로 미디어와 모션까지 다룹니다.

각 범주는 구체적인 요구사항의 짧은 목록으로 구성되며, 예를 들어 아이콘 전용 버튼의 aria-label, tabindex 0 초과 금지, 실패한 필드의 aria-invalid 등이 있습니다. 공통 수정 블록은 아이콘 전용 버튼, div-as-button, 연결되지 않은 폼 오류에 대한 전후 HTML을 보여주며, 리뷰 모드는 각 위반 사항을 인용된 줄, 왜 중요한지에 대한 한 문장, 코드 수준의 수정과 함께 리포트합니다.

검토 보고서
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    제약을 그 자리에 적용하기

    단독 명령을 실행하면 규칙이 해당 대화에서 진행 중인 모든 UI 작업에 대한 상시적인 제약이 되며, 단발성 감사가 아닙니다.

  2. 02
    위반 리포트를 위해 파일을 지정하기

    파일 인자를 주면 그 파일을 모든 규칙에 대해 검사하고, 각 위반 사항을 인용된 줄이나 코드 조각, 왜 중요한지에 대한 짧은 한 문장, 코드 수준의 수정과 함께 리포트합니다.

  3. 03
    범주를 우선순위 순서로 처리하기

    규칙은 영향도 등급이 부여된 순위 범주로 그룹화되어 있으며, 접근 가능한 이름이 우선순위 1로 critical로 표시됩니다.

  4. 04
    변경을 최소화하기

    이 스킬은 UI의 큰 부분을 다시 작성하지 말아야 하며, 수정은 최소한이고 표적화되어야 한다는 점을 명시하고 있습니다.

02 적합성 확인

fixing-accessibility Skill을 사용해야 하는 경우

이런 종류의 디자인 검토가 필요할 때 Claude Code 또는 Codex에서 fixing-accessibility 스킬을 사용하십시오. 적합성과 한계는 스킬의 자체 파일에서 가져옵니다.

적합한 경우

  • 기존 인터페이스에서 버튼, 링크, 입력, 메뉴, 다이얼로그, 탭, 드롭다운을 추가하거나 변경하기.
  • 검증, 오류 상태, 도움말 텍스트가 있는 폼을 만들기.
  • 키보드 단축키나 기타 커스텀 인터랙션을 구현하기.
  • 포커스 상태, 포커스 트래핑 또는 모달 동작을 작업할 때.
  • 아이콘 전용 컨트롤을 렌더링하거나, 호버 시에만 나타나는 상호작용이나 숨겨진 콘텐츠를 추가할 때.

한계 인지하기

  • 수정 중인 접근성 문제와 관련 없는 코드를 리팩터링할 때.
  • 네이티브 버튼, 링크 또는 입력으로 동일한 기능을 구현할 수 있는데도 역할 기반 임시방편을 사용할 때.
  • 소리가 포함된 미디어를 자동 재생할 때.

03 스킬 내부

fixing-accessibility Skill이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 아이콘 전용 컨트롤에는 반드시 이름을 지정합니다

    아이콘 전용 버튼은 단순히 보이는 글리프만 있는 것이 아니라 aria-label 또는 aria-labelledby를 통해 접근 가능한 이름을 가져야 합니다.

  2. 양수 tabindex는 절대 사용하지 않습니다

    0보다 큰 tabindex 값은 전면적으로 제외되며, 탭 순서는 자연스러운 순서에 맡깁니다.

  3. 다이얼로그에서 포커스를 트랩, 시드, 복원합니다

    모달은 열려 있는 동안 포커스를 트랩하고, 초기 포커스를 다이얼로그 내부로 설정하며, 닫힐 때 포커스를 트리거로 되돌려야 합니다.

  4. 오류를 해당 필드에 연결합니다

    오류는 aria-describedby로 입력과 연결되어야 하며, 그래야 메시지가 필드와 함께 안내됩니다.

  5. 실패한 필드는 invalid로 표시합니다

    유효하지 않은 필드는 단순히 오류 스타일을 표시하는 것이 아니라 aria-invalid를 설정해야 합니다.

  6. 네이티브 시맨틱이 이미 작동할 때는 ARIA를 사용하지 않습니다

    네이티브 시맨틱이 이미 문제를 해결하는 경우 aria를 추가하지 않습니다. 이는 도구 경계에서 중요한 제약 조건으로 다룹니다.

  7. 포커스를 보이게 유지합니다

    눈에 보이는 대체 요소가 제공되지 않는 한 포커스 아웃라인을 제거할 수 없습니다.

  8. UI 라이브러리를 마이그레이션하지 않습니다

    사용자가 명시적으로 요청하지 않는 한 UI 라이브러리 교체는 범위 밖입니다.

04 활용하기

Claude Code 또는 Codex에 fixing-accessibility 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자의 에이전트에 fixing-accessibility 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/ibelick/ui-skills --skill fixing-accessibility

skills/fixing-accessibility/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소마다 자체 경로를 문서화할 수 있습니다.

스킬에 첫 번째 디자인 리뷰 작업 부여

SKILL.md에는 예제 프롬프트가 포함되어 있지 않습니다. 이 스타터는 카탈로그 한 줄 설명에서 작성되었습니다. 작업 줄을 실제 브리프로 교체하십시오.

Starter prompt
Use the fixing-accessibility skill on the material I attach. What the skill should do here: Audits and fixes ARIA, keyboard, focus, contrast, and form errors. Rules: do not invent copy, data or brand assets. State your plan first, then produce the result and tell me what to check.

출처: SKILL.md가 아닌 카탈로그 한 줄 사용 설명에서 작성된 스타터 프롬프트입니다.

첫 번째 결과 확인

출력을 수락하기 전에 대화 기록과 파일에서 다음을 확인하십시오:

  • 결과는 이 스킬에 대해 카탈로그에 나열된 대로 검토 보고서로 제공됩니다.
  • 에이전트가 결과물을 생성하기 전에 계획 또는 대화 기록에서 fixing-accessibility 스킬을 언급합니다.
  • 사용자의 콘텐츠, 이름 및 숫자는 출력에서 변경되지 않습니다.

OpenDesign에서는 SKILL.md 링크를 통해 fixing-accessibility를 가져옵니다: Plugins → Add → Skill → Import from link를 사용한 다음, 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Repository
github.com/ibelick/ui-skills 브랜치 main
스킬 파일
skills/fixing-accessibility/SKILL.md 검증 시 기록된 콘텐츠 체크섬, 커밋 79081ab
License
MIT LICENSE에서 확인
리포지토리 스타
8,402 GitHub 스냅샷은 2026-09-14에 이 카탈로그의 5개 스킬을 포함하는 전체 ibelick/ui-skills 저장소에 대해 촬영되었습니다. fixing-accessibility에 대한 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.
스킬 자체 설명
"ARIA 레이블, 키보드 탐색, 포커스 관리, 색상 대비 및 양식 오류를 포함한 HTML 접근성 문제를 감사하고 수정합니다. 대화형 컨트롤, 양식, 대화 상자를 추가하거나 WCAG 준수를 검토할 때 사용합니다."

SKILL.md의 front-matter 설명입니다. 전체 파일은 약 4,714자입니다. GitHub에서 전체 파일 읽기.

접근성 수정

실제 디자인 검토 작업에서 fixing-accessibility를 실행합니다.

OpenDesign를 다운로드하고, SKILL.md 링크에서 fixing-accessibility를 가져온 다음, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/ibelick/ui-skills --skill fixing-accessibility

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원