CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

accesslint-audit

Find and fix WCAG 2.2 accessibility issues. Two modes — report (sweep a codebase or page, produce a prioritized written report, no edits) and fix (audit→edit→verify loop on a target). Prefers direct-CDP live-DOM auditing; falls back to a browser-MCP composition or HTML-string audits.

64

Quality

81%

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

81%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 lean, highly actionable instruction-only skill with excellent workflow sequencing — explicit baseline/verify loops, bail conditions, and escalation thresholds for a file-editing (fix) mode. The main weaknesses are the missing trigger guidance inherited from the description, no shown call syntax for the referenced audit tools, and no bundle files backing the referenced flows.

Suggestions

Include one concrete example call for each flow (e.g. how to invoke audit_live and what arguments it takes) so the guidance is copy-paste executable.

Trim the verbatim repetition of the frontmatter description in "When to Use" and the generic Limitations boilerplate to save context tokens.

If audit_live/audit_diff/explain_rule are meant to be bundle scripts, add them under scripts/ (or note they are built-in tools) so referenced paths resolve.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no explanations of what WCAG or CDP are — with every section carrying operational content. Minor trimmable redundancy remains: the "When to Use" section repeats the frontmatter description verbatim and the generic "Limitations" boilerplate could be tightened, so it fits the 4 ("efficient; minor instances that could be trimmed") rather than the 5 anchor.

4 / 5

Actionability

Concrete guidance throughout: a flow preference order with named tools ("audit_live", "audit_html", "audit_diff({ audit_name: \"before\" })", "explain_rule({ id })"), a grep fallback chain ("data-testid, id, aria-label → visible text → tree position"), and a full report template. However, the actual call syntax for the audit tools is never shown and no bundle scripts back them — minor gaps matching the 4 anchor rather than fully copy-paste-ready 5.

4 / 5

Workflow Clarity

Both modes have clear sequences with explicit validation and feedback loops: fix mode runs a baseline audit, applies fixes, then verifies via "audit_diff" that "-fixed covers your targets and +new is empty", with bail conditions ("Verification fails ... name it and stop") and stop-and-ask checkpoints (>50 violations, >10 mechanical fixes, out-of-scope files). This matches the 5 anchor: explicit validation steps, error-recovery loops, and escalation checklists.

5 / 5

Progressive Disclosure

The body is well-organized into clearly signaled sections (modes, flows, scope, approach, recipe, bail conditions, output) with no nested references. However, it references five distinct tools/prompts ("audit_live", "audit-live-page prompt", "audit_html", "audit_diff", "explain_rule") whose backing files do not exist in the bundle (no scripts/ or references/ directory), a minor organization gap that fits the 4 anchor rather than the fully well-split 5.

4 / 5

Total

17

/

20

Passed

Description

75%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, specific, third-person description that clearly delimits what the skill does and how its modes differ. Its one structural weakness is the missing "Use when..." trigger clause, which caps completeness and leaves natural invocation phrasings implicit.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks for an accessibility audit, a11y report, WCAG compliance check, or to fix accessibility issues."

Add common user synonyms such as "a11y" and "screen-reader/contrast checks" to widen natural trigger matching.

DimensionReasoningScore

Specificity

Multiple concrete actions are listed comprehensively: "Find and fix WCAG 2.2 accessibility issues", "sweep a codebase or page, produce a prioritized written report, no edits", "audit→edit→verify loop", and explicit preference for "direct-CDP live-DOM auditing" with fallbacks. Coverage of both modes and fallback strategies is comprehensive rather than leaving minor gaps, matching the 5 anchor.

5 / 5

Completeness

The "what" is clear and detailed (modes, fallbacks), but there is no "Use when..." clause or equivalent explicit trigger guidance — the description never states when to invoke the skill. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage — "WCAG 2.2", "accessibility issues", "audit", "report", "fix" — but common user phrasings like "a11y", "screen reader", or "contrast" are absent. A few natural terms are missing, matching the 4 anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

"WCAG 2.2 accessibility issues" carves out a clear niche with distinct trigger terms (WCAG, accessibility, a11y audit), and the two-mode + tooling description is unlikely to fire for unrelated skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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