CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/wcag-keyboard-navigation

Use when building or reviewing keyboard-only support or a modal, drawer or popover's focus handling: WCAG 2.2 keyboard access, no keyboard traps, shortcuts, focus order, visible and unobscured focus, with test scripts and the focus-trap pattern (focus on open, Escape, restore).

Quality

91%

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

Overview
Quality
Evals
Security
Files

Quality

Content

85%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 reference catalog: failure/fix tables, per-component test checklists, and a properly split-out companion reference make it highly actionable and navigable. The two weaker spots are the Overview's re-explanation of basic WCAG structure and the one Playwright snippet containing an ellipsis placeholder instead of a concrete assertion.

Suggestions

Trim the Overview's restatement of the four WCAG principles and A/AA/AAA conformance levels, and drop the verbatim spec quotes at the top of each SC section — Claude already knows these; keep only the per-SC failure patterns and fixes.

Replace the 'await expect(...).toBeVisible();' ellipsis in the Playwright example with a concrete assertion against a real locator so the script is copy-paste executable.

Add the missing natural trigger terms ('keyboard navigation', 'tab order', 'focus ring') to the skill description to improve trigger matching.

DimensionReasoningScore

Conciseness

The bulk is efficient tables, test scripts, and checklists, but the Overview re-states WCAG's four principles and A/AA/AAA levels, each SC section quotes spec text Claude already knows ('All functionality of the content is operable through a keyboard interface'), and SC 2.1.4 includes a rationale sentence that could be trimmed. Minor instances of over-explanation match the 4 anchor rather than the every-token-earns-its-place 5.

4 / 5

Actionability

Guidance is largely concrete and executable — specific fixes like ':focus-visible { outline: 2px solid var(--focus-ring); }', 'scroll-margin-top', and 'tabindex=-1', plus numbered per-component test steps. However, the single Playwright example contains a literal ellipsis ('await expect(...).toBeVisible();') making it not copy-paste ready, which keeps it at 'mostly executable with minor gaps' rather than 5.

4 / 5

Workflow Clarity

Each per-component pattern (Form, Modal, Menu, Tabs) is a fully sequenced test plan where every step is itself a verification with a stated expected outcome ('Escape closes the dialog and returns focus to the trigger', 'Tab cycles through dialog content only'). This is a review/test skill, not a destructive or batch operation, so the validation cap does not apply, and the checklist-style sequences with explicit expected results match the 5 anchor.

5 / 5

Progressive Disclosure

Verified against the actual bundle: one reference file (references/focus-trap.md, 256 lines) exists, is one level deep (no nested .md references, only external spec URLs), and is linked both at point of need in the SC 2.1.2 and Modal sections and again in the References section with a description of its contents. The deep 256-line focus-trap pattern is appropriately split out while the core SC catalog stays inline, matching the clear-overview anchor 5.

5 / 5

Total

18

/

20

Passed

Description

92%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: it names a clear niche, lists concrete capabilities, and pairs them with an explicit 'Use when' trigger clause covering both component-building and review contexts. The only gap is a handful of high-frequency natural phrasings ('keyboard navigation', 'tab order', 'focus ring') that would broaden trigger matching.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities across the whole domain: 'no keyboard traps, shortcuts, focus order, visible and unobscured focus, with test scripts and the focus-trap pattern (focus on open, Escape, restore)'. This is comprehensive, multi-action coverage rather than the 'several specific actions with minor gaps' of a 4.

5 / 5

Completeness

'Use when building or reviewing keyboard-only support or a modal, drawer or popover's focus handling' explicitly answers when, and the enumerated capability list explicitly answers what. Both are concrete and explicit, matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural terms like 'keyboard traps', 'modal, drawer or popover', 'Escape', and 'focus handling' are present, but the most likely user phrasings 'keyboard navigation', 'tab order', and 'focus ring' are absent. Good coverage with a few natural synonyms missing matches the 4 anchor, falling short of the synonym-complete 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The WCAG 2.2 keyboard/focus-management niche is clearly staked out with distinct triggers (keyboard traps, focus order, focus-trap pattern, Escape handling). It would not plausibly trigger a color-contrast or scanner skill, matching the minimal-conflict 5 anchor.

5 / 5

Total

19

/

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.

Reviewed

On this page