SkillAgentSearch skills...

a11y-audit

Static WCAG scan of HTML files (alt text, headings, labels, ARIA, lang, landmarks) and colour contrast checks for colour pairs or CSS

Install / Use

npx skills add borghei/Claude-Skills --skill a11y-audit

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Tags

Our assessment of a11y-audit

a11y-audit scores 86/100 on our quality scale, 2472nd of 4,702 Development & Engineering skills we index.

Its SKILL.md is 4.9 KB long, well organised into 24 sections with 2 code examples: a solid amount of guidance for an agent.

It has 817 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so a11y-audit is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

a11y-audit compared with similar skills

All 4 of these similar skills score higher than a11y-audit; compare them before choosing.

SkillScoreStarsUpdatedFormat
a11y-audit (this skill)by borghei8681757d agoSKILL.md
taste-skillby Leonxlnx100117.6k9d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.3ktodayCLAUDE.md
claude-howtoby luongnv8910047.4k3d agoCLAUDE.md
lobehubby lobehub10085.7ktodayMCP Server

Frequently asked questions

How do I install a11y-audit?
Run npx skills add borghei/Claude-Skills --skill a11y-audit. The install tabs above show the steps for each supported agent.
Which AI agents does a11y-audit work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is a11y-audit safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is a11y-audit still maintained?
The repository was last updated about 2 months ago, so a11y-audit is actively maintained.

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 author: borghei category: engineering domain: accessibility updated: 2026-04-02 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

# 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

a11y_scanner.py

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

Full Accessibility Audit

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

CI Integration

# 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

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

Reference Documentation

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

Related Skills

View on GitHub
GitHub Stars817
CategoryDevelopment
Updated1mo ago
Forks141

Languages

HTML

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium