CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

a11y-audit

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable skill body with real commands, complete tool documentation, and a worked example, held back mainly by a triple-redundant opening section that burns tokens restating the same pipeline three ways. The workflow includes a real verify-with-baseline checkpoint, though baseline creation is left implicit and one bundle asset is orphaned.

Suggestions

Collapse the 'Description' paragraph, 'What this skill does' list, and 'Features' table into a single overview section — they restate the same scan/fix/verify/report/CI pipeline three times and cost roughly 30 lines of tokens.

Show baseline creation in Phase 1 (e.g., 'python scripts/a11y_scanner.py /path/to/project --output audit-baseline.json') and add an explicit recovery step in Phase 3 for what to do when verification still reports violations or regressions.

Either reference assets/sample-component.tsx from the body (e.g., in the React audit example) or remove it from the bundle so every bundle file is discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

The bulk is dense and useful (command blocks, severity/pitfall tables, a full before/after example), but the opening is triple-padded: the 'Description' paragraph, the 'For every violation it finds...' sentence, and the 5-item 'What this skill does' list restate the same pipeline, and the Features table then duplicates that list item-for-item ('Full WCAG 2.2 Scan', 'Fix Code Generation', 'Compliance Reporting', 'CI/CD Integration'). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean anchor-5; it is not a 2 because the padding is confined to the intro and the remaining ~180 lines carry real, non-obvious a11y content.

3 / 5

Actionability

Everything is copy-paste executable: real invocations ('python scripts/a11y_scanner.py /path/to/project --json', 'python scripts/contrast_checker.py --fg "#777777" --bg "#ffffff"'), complete option listings for both bundled scripts, and a fully worked React before/after with WCAG IDs, severities, and measured contrast ratios. Common cases are covered by the pitfalls table giving a wrong pattern and its correct replacement. No gaps keep it at 4.

5 / 5

Workflow Clarity

The three phases (Scan → Fix → Verify) each carry a concrete command, and Verify is a genuine validation checkpoint with a feedback loop ('Re-run the scanner to confirm fixes and check for regressions' via --baseline audit-baseline.json), which also covers the batch fix mode. It falls short of anchor 5 because the baseline file's creation is never shown (Phase 1 uses --format table, not --output audit-baseline.json) and there is no explicit if-verification-fails recovery branch — 'minor validation gaps' per anchor 4.

4 / 5

Progressive Disclosure

Scored against the actual bundle: all 9 referenced references/*.md files exist, both referenced scripts exist, and a Reference Documentation table gives one-line navigation to each; references are one level deep and inline links (framework-a11y-patterns.md, examples-by-framework.md) are well-signaled. Two minor organization gaps keep it at anchor 4: assets/sample-component.tsx is present in the bundle but never mentioned in SKILL.md, and the ~30-line Tools Reference option lists could live in a reference file.

4 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A model description: third-person voice, concrete action verbs, explicit conformance levels and framework list, and a full 'Use when...' clause with natural synonyms (accessibility/a11y). It would reliably trigger on real user phrasing without overlapping other skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance' — and specifies the scope (Level A and AA) and all supported frameworks (React, Next.js, Vue, Angular, Svelte, plain HTML), matching the comprehensive-coverage anchor. It is not a 4 because coverage extends beyond 1-2 actions to a full pipeline with explicit framework enumeration and conformance levels.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is 'scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across [six frameworks]' and the 'when' is an explicit 'Use when...' clause with five concrete trigger phrases. This matches the anchor-5 example structure exactly; a 4 would require the when-clause to be vague or implicit, which it is not.

5 / 5

Trigger Term Quality

Trigger phrases are natural and include synonyms: 'auditing accessibility', 'fixing a11y violations', 'checking color contrast', 'generating compliance reports', 'integrating accessibility checks into CI/CD pipelines' — covering both the formal term (accessibility, WCAG 2.2) and the shorthand users actually say (a11y). Minor omissions (e.g., 'screen reader', 'ARIA') are not enough to drop below the comprehensive-synonyms anchor since the when-clause already spans five distinct trigger scenarios.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (WCAG 2.2 A/AA auditing with framework-specific fixes) with distinct triggers like 'a11y violations' and 'color contrast' that would not naturally route to a generic code-review or testing skill. Conflict risk is minimal; the anchor-4 'minor overlap risk' would apply to something like a generic 'frontend quality' description, not this.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

engineering-team/a11y-audit/skills/a11y-audit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.