CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

a11y-audit

Use for any accessibility audit or a11y fix (WCAG 2.2 A/AA, color contrast, compliance report, CI check) in React, Next.js, Vue, Angular, Svelte or HTML. Scans with a11y_scanner.py and checks contrast with contrast_checker.py, then fixes and re-verifies.

Quality

83%

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 highly actionable, well-structured skill body with executable commands, complete CLI references, and a clear three-phase workflow including a verification step. Main weaknesses are redundant frontmatter-restating sections (Description/Features) that inflate tokens, and an unreferenced bundle asset.

Suggestions

Remove the '## Description' section and trim the '## Features' table — both restate the frontmatter description; keep one concise capability summary.

Reference assets/sample-component.tsx from the body (e.g., as a practice target for the scanner) so every bundle file is discoverable.

Add an explicit feedback loop after Phase 3, e.g., 'If the baseline comparison shows remaining or new violations, return to Phase 2 and re-apply fixes before re-verifying.'

DimensionReasoningScore

Conciseness

Mostly efficient (dense tables, no explaining of concepts Claude already knows), but the "Description" section restates the frontmatter, the "Features" table largely duplicates it, and the "Related Skills" table adds little actionable value — noticeably tightenable. Not 4 because the duplication between the Description and Features sections is more than 'minor instances'; not 2 because there is no padded conceptual explanation or fluff.

3 / 5

Actionability

Fully executable throughout: copy-paste scanner and contrast-checker commands with flags ("python scripts/a11y_scanner.py /path/to/project --json"), complete CLI option blocks for both scripts, slash-command variants, and a full before/after React example with exact WCAG citations and contrast ratios. Matches the level-5 anchor covering the common cases.

5 / 5

Workflow Clarity

The three-phase Scan → Fix → Verify workflow is clearly sequenced with a command per phase and a verification checkpoint (Phase 3 re-run with "--baseline audit-baseline.json" to confirm fixes and check regressions). Not 5 because there is no explicit error-recovery loop (e.g., 'if violations remain, re-fix and re-scan') and the Fix phase delegates to a reference; not 3 because validation is present, so the batch-operation cap for missing verification does not apply.

4 / 5

Progressive Disclosure

Good structure scored against the actual bundle: all nine references/ files exist, are linked one level deep with a descriptive navigation table plus two inline point-of-use links, and both scripts are documented. Not 5 because assets/sample-component.tsx is never referenced from SKILL.md (orphaned asset), and the Common Pitfalls table is content that could live in a reference file to keep the overview lean.

4 / 5

Total

16

/

20

Passed

Description

83%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 strong description: third-person voice, explicit 'Use for...' trigger clause with concrete keywords, and named tooling for each action. Minor gaps in capability coverage (reporting, CI configs) and a few missing natural synonyms (screen reader, ARIA) keep it just short of top marks.

DimensionReasoningScore

Specificity

Names several concrete third-person actions — "Scans with a11y_scanner.py", "checks contrast with contrast_checker.py", "then fixes and re-verifies" — with the tool scripts explicitly named. Not 5 because capabilities demonstrated in the body (compliance report generation, CI integration, framework-specific fix code) are absent from the description; not 3 since it goes well beyond 1-2 generic actions.

4 / 5

Completeness

Explicitly answers both: what ("Scans with a11y_scanner.py and checks contrast with contrast_checker.py, then fixes and re-verifies") and when ("Use for any accessibility audit or a11y fix" with concrete parenthetical trigger phrases). Matches the level-5 anchor with concrete trigger phrases; level 4's 'when could be more explicit' does not apply here.

5 / 5

Trigger Term Quality

Good natural-term coverage including the "a11y" synonym, "WCAG 2.2 A/AA", "color contrast", "compliance report", "CI check", and all five framework names plus HTML. Not 5 because common user phrasings like "screen reader", "ARIA", "keyboard navigation", "tab order", or standards like "Section 508/ADA" are missing; not 3 since coverage with synonyms is clearly better than 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Accessibility auditing with WCAG triggers and named scanner scripts is a clear niche with minimal conflict risk. Not 5 because general code-review or frontend skills could plausibly claim overlapping triggers (e.g., "fix this component"); not 3 since the a11y/WCAG trigger set is far more distinct than 'somewhat specific'.

4 / 5

Total

17

/

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.