CtrlK
BlogDocsLog inGet started
Tessl Logo

accessibility

Audit and improve web accessibility following WCAG 2.1 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". Do NOT use for SEO (use seo), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit).

61

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./packages/skills-catalog/skills/(quality)/web-accessibility/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 reference with excellent ❌/✅ code examples, real audit commands, and a useful impact-prioritized issue list. Its weaknesses are duplication and structure: ~520 lines inline much of the WCAG criteria reference that already lives in references/WCAG.md (which is never linked), and the audit process is implicit rather than an explicit validate-and-re-check workflow.

Suggestions

Link references/WCAG.md from the body and move the criteria-level reference tables (POUR, conformance levels, contrast ratios) into it instead of duplicating them inline.

Add an explicit audit workflow with a validation loop: run Lighthouse/axe → triage by the Critical/Serious/Moderate list → apply fixes → re-run the audit to confirm the score improved.

Trim sections that re-teach what Claude already knows (standard visually-hidden and prefers-reduced-motion snippets, generic screen-reader command table) down to one-line reminders.

DimensionReasoningScore

Conciseness

The ~520-line body is mostly tight ❌/✅ code examples with little prose padding, but it re-states reference material Claude already knows well: the POUR principles table, conformance-level table, contrast ratio tables, the standard prefers-reduced-motion and visually-hidden snippets, and generic screen-reader command tables. Much of this duplicates references/WCAG.md, so it could be tightened considerably. It sits at anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') — below anchor 4 because whole sections re-teach known material, above anchor 2 because there is no conceptual filler prose.

3 / 5

Actionability

Nearly every section gives copy-paste-ready HTML/CSS/JS with correct/incorrect pairs, plus executable audit commands ("npx lighthouse https://example.com --only-categories=accessibility", "axe https://example.com") and a concrete manual-testing checklist. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases') — the modal focus trap, form labeling, error announcement, and ARIA tabs patterns are all directly usable.

5 / 5

Workflow Clarity

There is an implicit audit path — automated testing commands, manual testing checklist, then a prioritized fix list ("Critical (fix immediately)" / "Serious" / "Moderate") — but no explicit sequence or validation loop (e.g., run audit → fix → re-run audit to verify). This matches anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit'); it does not reach anchor 4, which requires a clear sequence with most checkpoints present, and exceeds anchor 2 because the components of a workflow are all present and organized.

3 / 5

Progressive Disclosure

Section structure by POUR principle is good with clear headers, but the actual bundle is mishandled: references/WCAG.md exists in the skill's bundle yet is never referenced from the body, and criteria-level reference material that belongs there (contrast tables, success-criteria listings) is instead inlined in SKILL.md. Per anchor 3 ('references present but not clearly signaled; content that should be separate is inline') this fits; it is above anchor 2 because the body is well-sectioned and navigable, and below anchor 4 because the one bundle file is completely unlinked while its content is duplicated inline.

3 / 5

Total

14

/

20

Passed

Description

82%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 with explicit what/when structure, natural trigger phrases including the 'a11y' synonym, and unusually good negative-trigger disambiguation against neighboring skills. The only weakness is that the capability statement is limited to two generic verbs ('audit and improve') rather than naming the specific issue classes the skill handles.

DimensionReasoningScore

Specificity

"Audit and improve web accessibility following WCAG 2.1 guidelines" names the domain plus two concrete actions (audit, improve), but stops there — no mention of fixing specific issue classes (contrast, labels, ARIA, keyboard traps) that the skill actually covers. This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); it is below anchor 4 ('lists several specific actions') because only two generic verbs are given, and above anchor 2 because the domain and both actions are explicit.

3 / 5

Completeness

The description explicitly answers both questions: what ("Audit and improve web accessibility following WCAG 2.1 guidelines") and when ("Use when asked to 'improve accessibility', 'a11y audit', ...") with concrete quoted trigger phrases. This directly matches the anchor 5 example pattern, including an explicit negative-trigger clause.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say — "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", "make accessible" — with the a11y synonym covered. It falls short of anchor 5's comprehensiveness (e.g., missing plain "accessibility check", alt text, color contrast, Section 508/ADA) but is clearly above anchor 3 ('missing common variations or synonyms').

4 / 5

Distinctiveness Conflict Risk

Clear niche (WCAG 2.1 web accessibility) with explicit disambiguation: "Do NOT use for SEO (use seo), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit)". Named adjacent skills are redirected, giving minimal conflict risk — a textbook anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (532 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository
tech-leads-club/agent-skills
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.