CH

check-accessibility

An accessibility audit tool that evaluates UI components against WCAG 2.2 standards.

Install

mkdir -p .claude/skills/check-accessibility && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3650" && unzip -o skill.zip -d .claude/skills/check-accessibility && rm skill.zip

Installs to .claude/skills/check-accessibility

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Review component for accessibility issues
41 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Validate semantic HTML structure for accessibility
  • Audit ARIA attribute usage and compliance
  • Test keyboard tab order and focus management
  • Verify color contrast and touch target size
  • Check motion and animation accessibility

How it works

Maps local component structure against W3C WCAG guidelines using automated standard fetching and manual analysis.

Inputs & outputs

You give it
Component name or path
You get back
Accessibility audit report with remediation steps

When to use check-accessibility

  • Check component accessibility
  • Verify WCAG compliance
  • Validate ARIA attributes
  • Test keyboard navigation

About this skill

Usage: /check-accessibility COMPONENT_NAME

Examples:

  • /check-accessibility button
  • /check-accessibility alert
  • /check-accessibility v2/lib/src/components/Button.ts

Check accessibility for: $ARGUMENTS

Setup:

  1. Read .claude/PROJECT_CONTEXT.md for AgnosticUI structure and accessibility principles

Process:

  1. Search for latest standards:

    • Use WebSearch for "WCAG 2.2 [component-type] accessibility"
    • Use WebSearch for "ARIA [specific-pattern] best practices"
    • Fetch W3C WAI-ARIA documentation if needed for specific patterns
  2. Locate component files:

    • Core component: v2/lib/src/components/$ARGUMENTS*
    • Framework implementations if relevant: v2/playgrounds/*/src/stories/*$ARGUMENTS*
    • Check PROJECT_CONTEXT for AgnosticUI's accessibility standards location
  3. Analyze against current standards:

    • Semantic HTML: Proper element usage for meaning and structure
    • ARIA attributes: Correct, necessary, and following latest specs
    • Keyboard navigation: Tab order, focus management, keyboard shortcuts
    • Focus indicators: Visible focus styles meeting contrast requirements
    • Screen reader support: Meaningful labels, descriptions, live regions
    • Color contrast: WCAG 2.2 AA requirements (4.5:1 text, 3:1 UI)
    • Touch targets: Minimum 44x44px for interactive elements
    • Motion/animation: Respects prefers-reduced-motion
  4. Framework-specific considerations:

    • Check if accessibility differs across Lit, React, Vue implementations
    • Verify ARIA is applied correctly in each framework's rendering
    • Test that events work with keyboard in all frameworks
  5. Report findings:

    • List issues with severity (Critical/High/Medium/Low)
    • Reference specific WCAG 2.2 success criteria
    • Provide remediation steps with code examples
    • Link to current W3C/MDN documentation
    • Note AgnosticUI-specific patterns to follow
  6. If fixes requested:

    • Propose changes that work across all frameworks
    • Ensure fixes align with AgnosticUI's CSS-first approach
    • WAIT FOR USER APPROVAL before implementing

AgnosticUI Accessibility Requirements:

  • WCAG 2.1 AA compliance minimum
  • Framework-agnostic solutions preferred
  • CSS custom properties for focus indicators
  • Consistent behavior across Lit, React, Vue

When not to use it

  • When analyzing non-UI code (e.g., CLI tools)
  • If the target library has no visual elements

Prerequisites

Access to project source code and standards

Limitations

  • Remediation requires manual developer intervention
  • Cannot fully verify screen reader behavior

How it compares

It is specifically tuned to project-specific design standards like AgnosticUI rather than general-purpose checkers.

Compared to similar skills

check-accessibility side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
check-accessibility (this skill)16moNo flagsIntermediate
roier-seo46moReviewIntermediate
a11y-audit04moReviewIntermediate
init15moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry