CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels, accessibility traits and hints, focus management, contrast, target size, and screen-reader support. Use when building or auditing UI for accessibility compliance, keyboard navigation, or screen-reader support.

63

Quality

79%

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 ./skills/accessibility/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 well-structured, platform-specific reference with genuinely executable examples and an accurate cross-platform API mapping. Its main gaps are conceptual over-explanation (POUR/Core Concepts), a workflow that ends at 'implement' with no validation/verification checkpoint, and content that could be split into per-platform reference files.

Suggestions

Add an explicit verification step to the workflow (e.g., 'Step 6: Validate — run axe-core or Lighthouse audits, and confirm screen-reader announcement of labels/hints'), turning the checklist into a validate-fix-retry loop.

Cut the 'Core Concepts' section's definitions of POUR and the accessibility tree — Claude already knows these — and keep only the skill-specific framing.

Deduplicate the target-size and focus-indicator guidance, which currently appears in Step 3, Anti-Patterns, and the checklist, stating each fact once.

DimensionReasoningScore

Conciseness

The body is mostly dense and useful, but the 'Core Concepts' section restates things Claude already knows ('POUR Principles', 'Accessibility Tree', 'Semantic Mapping: using native elements over generic containers'), and target-size/focus guidance is repeated across Step 3, Anti-Patterns, and the Best Practices Checklist. Not 4 because these are more than minor instances of over-explanation; not 2 because the code examples and mapping table are lean and earn their place.

3 / 5

Actionability

Concrete, executable code for all three platforms (HTML search form, SwiftUI button, Compose switch) plus a cross-platform API mapping table with real method names and specific WCAG values (4.5:1, 24x24px, SC numbers). Not 5 because the 'How It Works' steps are advisory directives ('Ensure...', 'Use consistent navigation patterns') without code or commands for the audit path (no axe/screen-reader testing commands).

4 / 5

Workflow Clarity

The five-step POUR sequence (Identify Role → Perceivable → Operable → Understandable → Robust) is clearly ordered, but there are no validation checkpoints or verification steps — nothing tells Claude how to confirm compliance (e.g., automated scanning or screen-reader testing), and the closing checklist is a static list rather than a validate-fix-retry loop. Not 4 because checkpoints are absent rather than merely minor gaps.

3 / 5

Progressive Disclosure

No bundle files exist, and the single body is well-organized with clear section headers, a compact ~135-line overview, and a one-level-deep References section of external links. Not 5 because the per-platform mapping tables and full example sets are the kind of content that would ordinarily split into reference files, keeping SKILL.md a leaner overview.

4 / 5

Total

14

/

20

Passed

Description

88%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 that clearly and explicitly states both capabilities and use triggers, with a comprehensive, specific capability list spanning three platforms. The only weaknesses are a slightly broad 'building UI' trigger and missing common synonyms like 'a11y'.

Suggestions

Add high-frequency synonyms such as 'a11y' or 'accessibility issues/fixes' to the 'Use when' clause to improve trigger recall.

Narrow the 'when building... UI' trigger to accessibility-motivated contexts (e.g., 'Use when building or auditing UI for accessibility...') to reduce overlap with general frontend-design skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Design, implement, and audit accessible UI to WCAG 2.2 Level AA' — and enumerates specific capabilities ('semantic ARIA roles and labels, accessibility traits and hints, focus management, contrast, target size, and screen-reader support'), giving comprehensive coverage across Web, iOS, and Android. Not 4 because there are no minor coverage gaps; the capability list is exhaustive for the domain.

5 / 5

Completeness

It explicitly answers both what ('Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android...') and when ('Use when building or auditing UI for accessibility compliance, keyboard navigation, or screen-reader support') with concrete trigger phrases. Not 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'accessibility compliance', 'keyboard navigation', and 'screen-reader support' appear, alongside 'auditing UI' and 'WCAG'. Not 5 because common synonyms users actually say are missing — 'a11y', 'accessibility issues', 'contrast', 'Section 508', or 'aria' as a standalone keyword.

4 / 5

Distinctiveness Conflict Risk

The accessibility/WCAG niche is clear and mostly distinct from sibling skills, but 'Use when building... UI' is broad enough to overlap with general frontend/design skills (e.g., frontend-patterns, design-system) that the body itself lists as related. Not 5 because of this overlap risk; not 3 because the accessibility-specific triggers (WCAG, screen readers, keyboard navigation) are strongly distinguishing.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/accessibility/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.