CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

a11y-debugging

Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines. Use when testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast.

75

1.64x
Quality

85%

Does it follow best practices?

Impact

46%

1.64x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 skill body: nearly every token conveys Chrome-DevTools-MCP-specific knowledge the model would not otherwise have, workflows are sequenced with explicit verification steps and fallbacks, and heavy code is correctly offloaded to a well-signaled one-level-deep reference file. The only room for improvement is trimming a handful of redundant explanatory phrases.

DimensionReasoningScore

Conciseness

The body is lean and focused on tool-specific knowledge Claude would not already know (pageId requirement, the .md.txt URL trick, report-parsing via a node one-liner, the headless contrast caveat). Not anchor 5 only because of a few trimmable phrases such as "This is much easier to read!" and "This efficiently extracts the selector and snippet..." which restate the adjacent instruction; it is well above anchor 3 since virtually no general-concept padding exists.

4 / 5

Actionability

Guidance is fully executable: exact tool names with exact parameters ("types: [\"issue\"]", "includePreservedMessages: true", press_key with "Tab"/"Shift+Tab"), a copy-paste-ready node one-liner for filtering the Lighthouse report (with the path placeholder explicitly flagged), and named, verified snippets in references/a11y-snippets.md for orphaned inputs, tap-target sizing, contrast, and global checks. Common cases are covered concretely, matching anchor 5.

5 / 5

Workflow Clarity

The eight numbered workflow patterns are clearly sequenced, starting from an explicit baseline ("Start by running a Lighthouse accessibility audit"), with explicit validation checkpoints in each ("A score < 1 indicates violations", "Ensure heading levels... do not skip levels", "Locate the element marked as focused... to verify focus moved"), a fallback feedback loop in the contrast pattern ("If native audits do not report issues... use evaluate_script"), and a Troubleshooting section for error recovery — matching anchor 5's sequence + validation + feedback-loop criteria.

5 / 5

Progressive Disclosure

SKILL.md serves as a clear overview and appropriately pushes the bulk executable code (four snippet implementations) into references/a11y-snippets.md, which exists, is one level deep, and its snippet titles match the names cited in the body. References are well signaled via bold snippet names plus markdown links, and sections (Core Concepts, Workflow Patterns, Troubleshooting) are easy to navigate, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Description

70%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 well-constructed description with an explicit, specific 'Use when...' clause and good natural trigger terms. Its main weakness is an abstract 'what' that relies on generic verbs ("debugging and auditing") rather than naming the concrete operations the skill performs.

Suggestions

Replace the generic verbs with 2-3 concrete actions, e.g. "Runs Lighthouse accessibility audits, inspects the accessibility tree via Chrome DevTools MCP snapshots, and checks contrast, tap-target, and keyboard-focus issues against web.dev guidelines."

Add widely-used synonyms such as "screen readers", "WCAG", or "accessibility audit" to the trigger list to improve keyword coverage.

Consider mentioning what the audits produce (e.g., failing-element reports with remediation advice) to sharpen the 'what' and distinguish it from general web-testing skills.

DimensionReasoningScore

Specificity

The description names the domain and tool ("Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines") but the stated actions — "debugging and auditing" — are generic; it never lists concrete operations like running Lighthouse audits, capturing accessibility-tree snapshots, or checking contrast ratios. This matches anchor 3 (domain plus 1-2 generic actions) better than anchor 4, which expects several specific actions listed.

3 / 5

Completeness

Both what and when are explicitly present: what is "Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines" and when is "Use when testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast" with concrete triggers. Falls just short of anchor 5 because the 'what' side is abstract ("debugging and auditing") rather than enumerating concrete actions as the anchor-5 example does; it is clearly above anchor 4's 'when could be more explicit' weakness since the when-clause is highly specific.

4 / 5

Trigger Term Quality

Strong natural triggers users would actually say: "semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast", plus the "a11y" abbreviation. Not anchor 5 because common natural terms like "screen reader", "WCAG", or "accessibility audit/report" are missing.

4 / 5

Distinctiveness Conflict Risk

The a11y/DevTools-MCP niche and triggers like "ARIA labels", "tap targets", and "color contrast" are mostly distinct with minimal conflict risk. Not anchor 5 because broader terms like "semantic HTML", "focus states", and "keyboard navigation" could also plausibly match general web-testing or frontend-development skills.

4 / 5

Total

15

/

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

ChromeDevTools/chrome-devtools-mcp

Path

skills/a11y-debugging/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.