Agent skill

A11y Audit

This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".

MITAuto-check passedFrontend & Design

Install A11y Audit

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a claude-code

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

GitHub CLI

$ gh skill install borghei/Claude-Skills 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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/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/

Paste into Claude Code

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .claude/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install borghei/Claude-Skills a11y-audit --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering/a11y-audit .agents/skills/a11y-audit && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .agents/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install borghei/Claude-Skills a11y-audit --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering/a11y-audit .cursor/skills/a11y-audit && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .cursor/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/borghei/Claude-Skills.git --path engineering/a11y-audit

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install borghei/Claude-Skills a11y-audit --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering/a11y-audit .gemini/skills/a11y-audit && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .gemini/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install borghei/Claude-Skills a11y-audit

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering/a11y-audit .github/skills/a11y-audit && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .github/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add borghei/Claude-Skills --skill a11y-audit -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install borghei/Claude-Skills a11y-audit --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering/a11y-audit .opencode/skills/a11y-audit && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "a11y-audit" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/a11y-audit into .opencode/skills/a11y-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-audit", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: a11y-audit
GitHub stars: 886
Token cost: ~1.3k tokens
SKILL.md length: 473 words
Files: 5 (incl. scripts, references)
Skills in repo: 354
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".

Works in 5 steps: Scan HTML - Run a11y_scanner.py on all… → Check contrast - Run contrast_checker.py… → Triage - Prioritize Level A violations… → …
Asks to check accessibility
SKILL.md covers Overview, Clarify First, Quick Start and Tools Overview, plus 3 more sections
Runs Python scripts from its folder; calls python

What it does

A11y Audit is an agent skill from borghei/Claude-Skills. This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/wcag-guidelines.md`, `scripts/a11y_scanner.py` and `scripts/contrast_checker.py`).

It sits in Frontend & Design, covering Accessibility. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

Asks to check accessibility
Audit WCAG compliance
Scan HTML for a11y issues
Check color contrast

Example prompts

“check accessibility”
“audit WCAG compliance”
“scan HTML for a11y issues”
“/a11y-audit”

Requirements

Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Scan HTML - Run a11y_scanner.py on all templates
Check contrast - Run contrast_checker.py on stylesheets
Triage - Prioritize Level A violations first
Remediate - Fix critical issues (alt text, form labels, headings)
Re-scan - Verify fixes pass all checks

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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
Ships 2 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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 1.3k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 473 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~52
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 473 words, ~1,256 tokens.

Download SKILL.mdSave it as .claude/skills/a11y-audit/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: a11y-audit
description: This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".
license: MIT + Commons Clause
metadata.version: 1.0.0
metadata.author: borghei
metadata.category: engineering
metadata.domain: accessibility
metadata.updated: 2026-04-02
metadata.tags: accessibility, a11y, wcag, contrast, html

Accessibility Audit

Category: Engineering Domain: Web Accessibility

Overview

The Accessibility Audit skill provides automated scanning of HTML files for WCAG 2.1 compliance violations and color contrast checking against AA/AAA standards. It catches missing alt text, broken heading hierarchies, unlabeled form inputs, and insufficient color contrast early in development.

Clarify First

Before running the audit, confirm these inputs. If any is unknown or vague, ASK — do not assume:

Target & scope — which HTML files, directory, or CSS to scan (determines what gets checked and the --file/--dir/--css arguments)
Conformance level — A, AA, or AAA target (sets contrast thresholds and which violations are CRITICAL vs WARNING vs INFO)
Use context — one-off remediation vs CI gate (drives --strict gating and JSON output)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

bash

# Scan HTML for WCAG violations
python scripts/a11y_scanner.py --file index.html

# Scan a directory of HTML files
python scripts/a11y_scanner.py --dir ./src/templates

# Check color contrast
python scripts/contrast_checker.py --foreground "#333333" --background "#ffffff"

# Parse CSS file for contrast issues
python scripts/contrast_checker.py --css styles.css

# JSON output for CI
python scripts/a11y_scanner.py --file index.html --format json

Tools Overview

Scans HTML files for WCAG 2.1 violations including structural, semantic, and interactive element issues.

Feature	Description
Image alt text	Detects missing or empty alt on non-decorative images
Heading hierarchy	Validates h1-h6 levels are sequential
Form labels	Ensures inputs have associated label elements
ARIA attributes	Checks ARIA usage correctness
Link text	Flags generic text like "click here" or "read more"
Language attribute	Checks for lang on html element
Tab order	Detects positive tabindex values
Landmarks	Validates semantic landmark usage

contrast_checker.py

Checks color contrast ratios against WCAG AA and AAA thresholds.

Feature	Description
Ratio calculation	Computes relative luminance contrast ratio
AA compliance	4.5:1 normal text, 3:1 large text
AAA compliance	7:1 normal text, 4.5:1 large text
CSS parsing	Extracts color/background pairs from CSS
Color suggestions	Recommends nearest compliant color

Workflows

Show full SKILL.md (194 more words)Show less

Full Accessibility Audit

Scan HTML - Run a11y_scanner.py on all templates
Check contrast - Run contrast_checker.py on stylesheets
Triage - Prioritize Level A violations first
Remediate - Fix critical issues (alt text, form labels, headings)
Re-scan - Verify fixes pass all checks

CI Integration

bash

# Gate on Level A violations
python scripts/a11y_scanner.py --dir ./templates --format json --level A --strict

# Check CSS contrast
python scripts/contrast_checker.py --css ./static/css/main.css --format json

Development Workflow

Pre-commit - Quick scan of changed HTML files
PR review - Full scan as part of review checklist
Staging audit - Comprehensive scan before release
Monitoring - Regular scheduled audits

Reference Documentation

WCAG Guidelines - Conformance levels, success criteria, common fixes

Common Patterns Quick Reference

WCAG Levels

Level	Description	Typical Requirement
A	Minimum baseline	Legal compliance
AA	Industry standard	Most regulations, ADA
AAA	Enhanced	Best practice goal

Contrast Ratios

Context	AA	AAA
Normal text (<18pt)	4.5:1	7:1
Large text (>=18pt bold or >=14pt)	3:1	4.5:1
UI components	3:1	3:1

Quick Fixes

Issue	Fix
Missing alt text	`<img alt="Description of image">`
Skipped heading	Use sequential h1 through h6
No form label	`<label for="inputId">Label</label>`
Generic link text	Replace "click here" with descriptive text
Missing lang	`<html lang="en">`
Positive tabindex	Use tabindex="0" or tabindex="-1" only

Severity Mapping

CRITICAL - WCAG Level A violations
WARNING - WCAG Level AA violations
INFO - WCAG Level AAA recommendations

Files

SKILL.md and 4 other files (scripts, references) in engineering/a11y-audit of borghei/Claude-Skills.

SKILL.md
examples/sample-page.html
references/wcag-guidelines.md
scripts/a11y_scanner.py
scripts/contrast_checker.py

Open the folder on GitHubat commit 4a698e8

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
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
A11y Audit this skillborghei/Claude-Skills	886	—	~1.3k	Automated safety check: Pass	MIT	2 days ago
Web Interface Guidelines Reviewervercel-labs/openreview	1.7k	97 repos	~308	Automated safety check: Pass	None	7 mo ago
Accessibility Reviewmarkmead/hyperui	12k	1 repos	~1.1k	Automated safety check: Pass	MIT	13 days ago
Web Animation DesignbaptisteArno/typebot.io	11k	2 repos	~2.7k	Automated safety check: Pass	Custom licence	2 days ago
Accessibility Fixeribelick/ui-skills	9.5k	4 repos	~1.2k	Automated safety check: Pass	MIT	2 days ago
Wcag Audit PatternsvmDeshpande/ai-agent-automation	178	11 repos	~610	Automated safety check: Pass	Apache-2.0	27 days ago

Similar skills

Web Interface Guidelines Reviewer
vercel-labs/openreview
Official
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…
1.7k GitHub starsUsed in 97 repos~308 tokens
Frontend & DesignAuto-check passed
Accessibility Review
markmead/hyperui
Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.
12k GitHub starsUsed in 1 repo~1.1k tokens
Frontend & DesignAuto-check passed
Web Animation Design
baptisteArno/typebot.io
Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.
11k GitHub starsUsed in 2 repos~2.7k tokens
Frontend & DesignAuto-check passed
Accessibility Fixer
ibelick/ui-skills
Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.
9.5k GitHub starsUsed in 4 repos~1.2k tokens
Frontend & DesignAuto-check passed
Wcag Audit Patterns
vmDeshpande/ai-agent-automation
Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.
178 GitHub starsUsed in 11 repos~610 tokens
Frontend & DesignAuto-check passed
Baseline UI
ibelick/ui-skills
Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.
9.5k GitHub starsUsed in 8 repos~855 tokens
Frontend & DesignAuto-check passed

Questions about A11y Audit

What does A11y Audit do?

This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages". A11y Audit is an agent skill from borghei/Claude-Skills. This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".

When should I use A11y Audit?

A11y Audit fits situations like: asks to check accessibility; audit WCAG compliance; scan HTML for a11y issues; check color contrast.

How do I install A11y Audit in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill a11y-audit -a claude-code`. Or copy the skill folder (engineering/a11y-audit in borghei/Claude-Skills) 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 borghei/Claude-Skills --skill a11y-audit -a codex`. Or copy the skill folder (engineering/a11y-audit in borghei/Claude-Skills) 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 borghei/Claude-Skills --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?

Going by SKILL.md and its folder, A11y Audit needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does A11y Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does A11y Audit use?

A11y Audit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does A11y Audit use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to A11y Audit?

Skills that share tags, products or a category with A11y Audit: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains A11y Audit?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

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

Install A11y Audit

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Accessibility Audit

Overview

Clarify First

Quick Start

Tools Overview

a11y_scanner.py

contrast_checker.py

Workflows

Full Accessibility Audit

CI Integration

Development Workflow

Reference Documentation

Common Patterns Quick Reference

WCAG Levels

Contrast Ratios

Quick Fixes

Severity Mapping

Files

Compare with similar skills

Similar skills

More from borghei/Claude-Skills

Related

Questions about A11y Audit