Communitygithub.com

접근성 검토 (Accessibility Review)

디자인이나 페이지에 대해 WCAG 2.1 AA 접근성 감사를 실행합니다. "접근성 감사", "a11y 확인", "이것 접근 가능한가요?" 또는 디자인 핸드오프 전에 색상 대비, 키보드 내비게이션, 터치 대상 크기, 스크린 리더 동작을 검토할 때 트리거하세요.

접근성 검토 (Accessibility Review)란 무엇인가요?

이 스킬은 디자인 또는 웹 페이지가 WCAG 2.1 AA 접근성 표준을 준수하는지 감사하는 Agent skill입니다. 사용자는 '/accessibility-review $ARGUMENTS' 명령어로 감사를 시작하거나 자연어 요청(예: "접근성 감사 실행해 줘")으로 트리거할 수 있습니다. 이 스킬은 지각 가능성, 운용 가능성, 이해 가능성, 견고성의 네 가지 원칙에 따라 20개 이상의 세부 기준을 점검합니다. 주요 점검 항목으로는 색상 대비(본문 4.5:1, 큰 텍스트 3:1), 키보드 내비게이션, 터치 대상 크기(44x44 CSS 픽셀), ARIA 랜드마크, 폼 레이블, 스크린 리더 호환성 등이 포함됩니다. 감사 결과는 마크다운 형식의 구조화된 보고서로, 발견된 문제(심각도별 분류), 색상 대비 검증표, 키보드 내비게이션 동작 분석, 스크린 리더 발화 확인, 우선순위 수정 사항을 제공합니다. 또한 연결된 디자인 도구(Figma)나 프로젝트 트래커가 있을 경우 인라인 검사나 이슈 티켓 자동 생성이 가능합니다. 이 스킬은 Claude Code, Cursor, Codex 등 주요 Agent 플랫폼에서 사용할 수 있으며, 사용자에게 자동화된 스캔(약 30% 문제 발견), 키보드 전용 탐색, 수동 스크린 리더 테스트를 결합한 체계적인 테스트 접근법을 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/plugins/anthropic-design/skills/accessibility-review

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/accessibility-review

낯선 플레이스홀더를 보거나 연결된 도구를 확인해야 한다면 CONNECTORS.md를 참조하세요.

디자인 또는 페이지를 WCAG 2.1 AA 접근성 준수 여부에 대해 감사합니다.

사용법

/accessibility-review $ARGUMENTS

접근성 감사: @$1

WCAG 2.1 AA 빠른 참조

지각 가능성(Perceivable)

  • 1.1.1 비텍스트 콘텐츠는 대체 텍스트가 있어야 함
  • 1.3.1 정보와 구조는 의미적으로 전달되어야 함
  • 1.4.3 대비 비율 >= 4.5:1 (일반 텍스트), >= 3:1 (큰 텍스트)
  • 1.4.11 비텍스트 대비 >= 3:1 (UI 컴포넌트, 그래픽)

운용 가능성(Operable)

  • 2.1.1 모든 기능은 키보드로 사용 가능해야 함
  • 2.4.3 논리적인 포커스 순서
  • 2.4.7 가시적인 포커스 표시기
  • 2.5.5 터치 대상 >= 44x44 CSS 픽셀

이해 가능성(Understandable)

  • 3.2.1 포커스 시 예측 가능 (예상치 못한 변경 없음)
  • 3.3.1 오류 식별 (오류를 설명)
  • 3.3.2 입력에 대한 레이블 또는 지침

견고성(Robust)

  • 4.1.2 모든 UI 컴포넌트의 이름(name), 역할(role), 값(value)

일반적인 문제

  1. 색상 대비 부족
  2. 폼 레이블 누락
  3. 대화형 요소에 키보드 접근 불가
  4. 의미 있는 이미지에 대체 텍스트 누락
  5. 모달 내 포커스 트랩
  6. ARIA 랜드마크 누락
  7. 자동 재생 미디어에 제어 기능 없음
  8. 연장 옵션 없는 시간 제한

테스트 접근법

  1. 자동화 스캔 (약 30% 문제 발견)
  2. 키보드 전용 내비게이션
  3. 스크린 리더 테스트 (VoiceOver, NVDA)
  4. 색상 대비 확인
  5. 200% 확대 — 레이아웃이 깨지는가?

출력

## 접근성 감사: [디자인/페이지 이름]
**표준:** WCAG 2.1 AA | **날짜:** [날짜]

### 요약
**발견된 문제:** [X] | **심각:** [X] | **중요:** [X] | **경미:** [X]

### 발견 사항

#### 지각 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [1.4.3 대비] | 🔴 심각 | [수정] |

#### 운용 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [2.1.1 키보드] | 🟡 중요 | [수정] |

#### 이해 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [3.3.2 레이블] | 🟢 경미 | [수정] |

#### 견고성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [4.1.2 이름, 역할, 값] | 🟡 중요 | [수정] |

### 색상 대비 확인
| 요소 | 전경색 | 배경색 | 비율 | 요구 비율 | 통과? |
|------|--------|--------|------|----------|-------|
| [본문 텍스트] | [색상] | [색상] | [X]:1 | 4.5:1 | ✅/❌ |

### 키보드 내비게이션
| 요소 | 탭 순서 | Enter/Space | Escape | 화살표 키 |
|------|---------|-------------|--------|----------|
| [요소] | [순서] | [동작] | [동작] | [동작] |

### 스크린 리더
| 요소 | 발화 내용 | 문제 |
|------|----------|------|
| [요소] | [스크린 리더가 말하는 내용] | [문제가 있다면] |

### 우선순위 수정
1. **[심각 수정]** — [누구에게] 영향을 미치며 [무엇을] 차단함
2. **[중요 수정]** — [누구에게] [무엇을] 개선함
3. **[경미 수정]** — 있으면 좋은 수준

연결된 도구가 있을 경우

~~디자인 도구가 연결된 경우:

  • Figma에서 색상 값, 글꼴 크기, 터치 대상을 직접 검사
  • 디자인 스펙에서 컴포넌트의 ARIA 역할과 키보드 동작 확인

~~프로젝트 트래커가 연결된 경우:

  • 각 접근성 발견 사항에 대해 심각도와 WCAG 기준을 포함한 티켓 생성
  • 발견 사항을 기존 접근성 개선 에픽에 연결

팁

  1. 대비와 키보드부터 시작하세요 — 가장 흔하고 영향력이 큰 문제를 잡을 수 있습니다.
  2. 실제 보조 기술로 테스트하세요 — 제 감사는 좋은 출발점이지만, VoiceOver/NVDA로 수동 테스트하면 제가 놓칠 수 있는 부분을 찾을 수 있습니다.
  3. 영향도에 따라 우선순위를 정하세요 — 사용자를 차단하는 문제를 먼저 고치고, 이후에 개선하세요.

Individual skills in this repo

This repo contains 15 individual skills — each has its own dedicated page.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

관련 스킬