Agent skill

A11y Audit

by scaleway in scaleway/ultraviolet

Audit components for accessibility. An agent skill from scaleway/ultraviolet.

Apache-2.0Auto-check passedFrontend & Design

Install A11y Audit

skills CLI
$ npx skills add scaleway/ultraviolet --skill a11y-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install scaleway/ultraviolet a11y-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/scaleway/ultraviolet.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/a11y-audit .claude/skills/a11y-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
a11y-audit
GitHub stars
127
Token cost
~967 tokens
SKILL.md length
461 words
Files
3
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Audit components for accessibility. An agent skill from scaleway/ultraviolet.

  • Works in 6 steps: Identify the component → Find a corresponding ARIA Pattern → Find WCAG rules → …
  • Asked to create
  • SKILL.md covers Workflow and Action Summary & Prioritization
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

A11y Audit is an agent skill from scaleway/ultraviolet. Audit components for accessibility. Use when asked to create or update an accessibility audit or A11y.mdx file for a React component.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files.

It sits in Frontend & Design, covering Accessibility and React components. It works with React. The repository describes itself as: A monorepo Design System with React components. The licence is Apache-2.0.

When your agent uses it

  • Asked to create
  • Update an accessibility audit
  • A11y.mdx file for a React component

Example prompts

  • “/a11y-audit”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Identify the component
  2. Find a corresponding ARIA Pattern
  3. Find WCAG rules
  4. Analyze the React component
  5. Generate and fill A11y.mdx file
  6. Update Storybook configuration

What it can do on your machine

Read from SKILL.md and the folder at commit 29d7205. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • w3.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

A11y Audit loads about 967 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 461 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~967

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from scaleway/ultraviolet at commit 29d7205, republished under its Apache-2.0 licence (© scaleway). 461 words, ~967 tokens.

Download SKILL.mdSave it as .claude/skills/a11y-audit/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
a11y-audit
description
Audit components for accessibility. Use when asked to create or update an accessibility audit or A11y.mdx file for a React component.

Accessibility Audit for React Components

Workflow

Step 1: Identify the component

Before doing anything else you must identify what kind of component you're auditing. If the component name is not self-explanatory, you can read its source file(s) or test files to understand what the component does and associate it with a well-known component type.

Once you have identified the component, tell the user a few words about this component and what it does, then move on to step 2.

Step 2: Find a corresponding ARIA Pattern

Given the type of component to audit, browse the WAI-ARIA Authoring Practices and see if there is an existing ARIA Pattern for the component, or guidelines for implementing ARIA roles, states, and properties

Tell the user if you found something and keep this reference for later.

Step 3: Find WCAG rules

Important: Take all the time you need for this step, it is crucial that you don't miss any rules. It is better to have too many rules than to miss relevant ones.

Given the type of component to audit, use the WCAP MCP to find relevent rules that apply to the component.

Step 4: Analyze the React component

Important: Start skeptical. Assume the React component has accessibility issues until proven otherwise.

Read the component file(s) to understand:

  • Component type (interactive, layout, feedback, etc.)
  • Props and features
  • Current ARIA attributes
  • Keyboard handlers (onKeyDown, onKeyUp, etc.)
  • Focus management (tabindex, focus traps, etc.)
  • React-specific patterns (portals, context, hooks)

Based on the ARIA pattern and WCAG rules that you found in previous steps, identify any accessibility issues or missing features. Be as comprehensive as possible.

If the component has an aria-label property and no accessibleLabel property, add an entry in the accessibility issues to add the accessibleLabel property to implement the chosen decision in RFC #6585 (https://github.com/scaleway/ultraviolet/discussions/6585), deprecate the aria-label property and use its value as a fallback for the accessibleName.

Show full SKILL.md (147 more words)Show less
Step 5: Generate and fill A11y.mdx file

Create a file path/to/component/__stories__/A11y.mdx following the template .agents/skills/a11y-audit/resources/audit-template.mdx. You can find the "Component Path" in the stories path/to/component/__stories__/index.stories.tsx.

Fill the A11y.mdx file with your findings from the previous step and following indications in the template file. You can find an example of a full A11y.mdx file in .agents/skills/a11y-audit/resources/audit-example.mdx.

Step 6: Update Storybook configuration

Update the path/to/component/__stories__/index.stories.tsx file and complete or update the a11yStatus parameter.

tsx
import type { Meta } from '@storybook/react-vite'
import { Component } from '..'

export default {
  component: Component,
  title: 'UI/Category/Component',
  parameters: {
    a11yStatus: {
      perceivable: true | false,
      operable: true | false,
      understandable: true | false,
      robust: true | false,
    },
  },
} satisfies Meta<typeof Component>

Set a11yStatus flags based on the WCAG rules identified earlier:

  • perceivable: false if at least one rule with index 1.x.x fails, otherwise true
  • operable: false if at least one rule with index 2.x.x fails, otherwise true
  • understandable: false if at least one rule with index 3.x.x fails, otherwise true
  • robust: false if at least one rule with index 4.x.x fails, otherwise true

Action Summary & Prioritization

After analyzing a component, provide a short summary of your findings.

© scaleway, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in .agents/skills/a11y-audit of scaleway/ultraviolet.

  • SKILL.md
  • resources/audit-example.mdx
  • resources/audit-template.mdx

Open the folder on GitHubat commit 29d7205

Compare with similar skills

A11y Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

A11y Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
A11y Audit this skillscaleway/ultraviolet127—~967Automated safety check: PassApache-2.0
Connect Component To Figmadequelabs/cauldron129—~2kAutomated safety check: PassMPL-2.0
Framer Component Best Practicesframer/plugins138—~1.3kAutomated safety check: PassMIT
Base UI Reactsecondsky/claude-skills227—~1.9kAutomated safety check: PassMIT
Stitch to React and Vite Dashboardgoogle-labs-code/stitch-skills8.4k—~914Automated safety check: NotesApache-2.0
Design Code for Any Frameworkplugin87/ux-ui-agent-skills1.6k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Connect Component To Figma

    dequelabs/cauldron

    Add a Figma Code Connect (.figma.tsx) file for a Cauldron React component.

    129 GitHub stars~2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Best practices for building and improving React code components in Framer, a no-code website builder.

    138 GitHub stars~1.3k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Base UI React

    secondsky/claude-skills

    MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.

    227 GitHub stars~1.9k tokensUpdated 11 days ago
    Frontend & DesignAuto-check passed
  • Stitch to React and Vite Dashboard

    google-labs-code/stitch-skills

    Official

    Turns Stitch screens into a React, Vite and TypeScript dashboard with TanStack Query data fetching, DESIGN.md tokens as CSS variables and optional read-only Web3 data.

    8.4k GitHub stars~914 tokensUpdated 1 mo ago
    Frontend & DesignAuto-check: notes
  • Design Code for Any Framework

    plugin87/ux-ui-agent-skills

    Generates complete, accessible, token-driven UI component code for a chosen framework such as React with Tailwind, SwiftUI, Vue, Flutter or Jetpack Compose.

    1.6k GitHub stars~1.7k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Shift UI Components

    shift-editor/shift

    Guides design, implementation and review of Shift interface work: shared Base UI wrappers, Tailwind v4 theme tokens, Figma matching and accessible interaction states.

    348 GitHub stars~2.5k tokensUpdated today
    Frontend & DesignAuto-check passed

More from scaleway/ultraviolet

  • A11y Fix

    scaleway/ultraviolet

    Fix accessibility issues documented in a component's A11y.mdx audit file by editing the component source, then refresh the audit artifacts.

    127 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Unit Testing

    scaleway/ultraviolet

    Write Vitest/Testing Library tests the Ultraviolet way — interact with the rendered DOM like a user, following query priority.

    127 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Create PR

    scaleway/ultraviolet

    Create or update a GitHub Pull Request — analyze the diff, draft the description from the repo template, push with gh.

    127 GitHub stars~566 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about A11y Audit

What does A11y Audit do?

Audit components for accessibility. An agent skill from scaleway/ultraviolet. A11y Audit is an agent skill from scaleway/ultraviolet. Audit components for accessibility.

When should I use A11y Audit?

A11y Audit fits situations like: asked to create; update an accessibility audit; A11y.mdx file for a React component.

How do I install A11y Audit in Claude Code?

Run `npx skills add scaleway/ultraviolet --skill a11y-audit -a claude-code`. Or copy the skill folder (.agents/skills/a11y-audit in scaleway/ultraviolet) into .claude/skills/a11y-audit in your project. Claude Code loads it when a task matches its description.

How do I install A11y Audit in Codex?

Run `npx skills add scaleway/ultraviolet --skill a11y-audit -a codex`. Or copy the skill folder (.agents/skills/a11y-audit in scaleway/ultraviolet) into .agents/skills/a11y-audit in your project. Codex loads it when a task matches its description.

Can I use A11y Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add scaleway/ultraviolet --skill a11y-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/a11y-audit, .gemini/skills/a11y-audit, .github/skills/a11y-audit and .opencode/skills/a11y-audit in your project.

What does A11y Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: A11y Audit is instructions for the agent only.

Does A11y Audit access the network?

SKILL.md names 1 domain. As links in the text: w3.org. This is read from the text; nothing was executed.

Is A11y Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does A11y Audit use?

A11y Audit is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does A11y Audit use?

About 967 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to A11y Audit?

Skills that share tags, products or a category with A11y Audit: Connect Component To Figma (dequelabs/cauldron, 129 stars), Framer Component Best Practices (framer/plugins, 138 stars), Base UI React (secondsky/claude-skills, 227 stars) and Stitch to React and Vite Dashboard (google-labs-code/stitch-skills, 8.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains A11y Audit?

scaleway (a GitHub organization) maintains it in scaleway/ultraviolet, which has 127 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 8, 2026.

Source: scaleway/ultraviolet on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.