본문으로 건너뛰기

접근성 수정 스킬

이름, 키보드 접근, 포커스, 의미 구조와 알림을 작고 구체적인 변경으로 검토합니다.

커뮤니티 · ibelick
작성자ibelick
라이선스MIT
소스ibelick/ui-skills · GitHub의 SKILL.md
프로젝트 웹사이트www.ui-skills.com
작동 환경Claude Code · Codex, Gemini CLI, Cursor, Copilot
소스 확인 날짜

fixing-accessibility는 기존 기술 스택에서 구체적인 UI 접근성 문제를 고치도록 에이전트를 안내합니다.

이름 있는 컨트롤, 키보드 접근, 포커스, 기본 의미 구조와 연결된 양식 오류를 우선합니다. 체크리스트 검토는 적합성 인증이 아닙니다.

스킬의 SKILL.md에서: # fixing-accessibility

ibelick의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 이름 누락, 접근할 수 없는 컨트롤과 잘못된 포커스 동작을 찾습니다.
  2. 기본 의미 구조를 사용하고 오류를 해당 필드에 연결합니다.
  3. 알림, 대비, 자막과 동작 환경설정을 검토합니다.

얻을 수 있는 결과물

  • 범위를 한정한 HTML, ARIA, CSS 또는 구성 요소 변경.
  • 정확한 코드 조각과 실패 현상에 연결된 검토 메모.

이럴 때 사용하세요

  • 납품 전에 양식, 대화 상자나 상호작용 구성 요소를 검토합니다.
  • 현재 UI 라이브러리 안에서 키보드와 화면 읽기 도구 결함을 수정합니다.

이럴 때는 맞지 않습니다

  • 소스 검토만으로 완전한 보조 기술 감사를 했다고 간주하는 경우.

필요한 것

  • 대상 인터페이스 소스 접근과 요청된 수정을 할 권한.
  • 실행 검사를 위한 브라우저와 보조 기술. 필수 패키지, 계정이나 MCP 서버는 없습니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md우선순위가 있는 접근성 규칙과 예시.

2026-11-17 기준 저장소에 있는 라이선스: MIT.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 이 대화 상자의 초기 포커스, 포커스 가두기, Escape 키와 포커스 복원을 고치세요.
  • 기본 레이블과 적절한 ARIA로 양식 오류를 입력 필드에 연결하세요.
  • 이 도구 모음의 키보드 접근성과 접근 가능한 컨트롤 이름을 검토하세요.

fixing-accessibility 설치 방법

기존 기술 스택

프로젝트를 검사할 수 있는 에이전트에 스킬 폴더를 복사하세요. UI 라이브러리나 자동 감사 도구를 설치하지는 않습니다.

브라우저와 화면 읽기 도구로 결과 동작을 확인하세요. 실행하지 않은 검사를 보고하지 마세요.

스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.

Claude Code: 스킬 폴더에 복사

이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).

git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p ~/.claude/skills
cp -R ui-skills/skills/fixing-accessibility ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /fixing-accessibility를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.

git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p .agents/skills
cp -R ui-skills/skills/fixing-accessibility .agents/skills/
에이전트프로젝트 폴더사용자 폴더참고
OpenAI Codex
.agents/skills/
~/.agents/skills/
$를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

실행 근거가 있는 작은 수정

원본은 정확한 코드 조각과 구체적인 실패 현상을 제시한 뒤 제한적으로 수정하도록 합니다. 무관한 리팩터링이나 라이브러리 이전은 권하지 않습니다.

수정 후 오류 알림과 올바른 컨트롤로의 포커스 복원을 포함한 전체 상호작용을 확인하세요.

fixing-accessibility에 관한 질문

접근성 라이브러리가 필요한가요?

아니요. 프로젝트에 이미 있는 기본 요소와 검증된 공통 요소를 우선합니다.

모든 곳에 ARIA를 추가해야 하나요?

아니요. 기본 의미 구조가 우선이며 불필요한 ARIA는 사용을 더 어렵게 만들 수 있습니다.

동작 효과도 다루나요?

더 우선적인 이름, 키보드와 포커스 규칙과 함께 동작 줄이기와 미디어 지침도 포함합니다.

검토를 마치면 WCAG 준수가 입증되나요?

아니요. 범위, 콘텐츠와 실제 보조 기술 동작은 더 폭넓게 검증해야 합니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리