wcag-audit-patterns

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

1.06x

Quality

72%

Does it follow best practices?

Impact

95%

1.06x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md

The canonical home for this skill is wcag-audit-patterns in wshobson/agents

Quality

Content

57%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 thorough, actionable WCAG audit reference with strong code examples and remediation patterns, but it is verbose, lacks an explicitly sequenced audit workflow with validation checkpoints, and inlines content that would benefit from separate reference files.

Suggestions

Add an explicit step-by-step audit workflow (e.g., 1. Run automated scan → 2. Manual verification → 3. Document violations → 4. Remediate → 5. Re-test) with validation checkpoints and a fix-retest feedback loop.

Move the full per-criterion checklist and remediation patterns into reference files under references/ and link to them one level deep, keeping SKILL.md as a concise overview.

Trim concept explanations Claude already knows (POUR principles, conformance-level table) to reduce token cost while retaining the actionable checklists.

Dimension	Reasoning	Score
Conciseness	The body restates concepts Claude already knows (POUR principles, conformance-level table, common-violations tree) and enumerates the full WCAG checklist, making it lengthy; the checklists are useful reference material but the overall token budget is heavier than necessary.	3 / 5
Actionability	Concrete, executable guidance is provided throughout: axe-core integration code, exact CLI commands (npx @axe-core/cli, pa11y, lighthouse), and before/after remediation snippets in HTML/CSS/JS, with only minor gaps where checklist items lack specific test commands.	4 / 5
Workflow Clarity	Sections imply an audit order (checklist → automated testing → remediation) but there is no explicitly sequenced multi-step audit process with validation checkpoints or a verify-fix-retest feedback loop, which is important for a verification-heavy task.	3 / 5
Progressive Disclosure	The file has good section headers but inlines ~550 lines of detailed checklist and reference material with no bundle files or one-level-deep references to split the bulk into separate files.	3 / 5
	Total	13 / 20 Passed

Description

87%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-crafted description that clearly answers both what the skill does and when to invoke it, with strong distinctiveness and good natural trigger terms. Specificity and trigger-term coverage are solid but could reach the top anchor with more granular actions and additional synonyms.

Dimension	Reasoning	Score
Specificity	"Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance" names the domain plus several specific actions, though the actions are category-level rather than granular, leaving minor coverage gaps.	4 / 5
Completeness	It explicitly states what the skill does ("Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance") and when to use it ("Use when auditing websites for accessibility, fixing WCAG violations..."), answering both with concrete trigger phrases.	5 / 5
Trigger Term Quality	"auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns" offers good natural keyword coverage, but misses common synonyms such as a11y, screen readers, or Section 508 that users might say.	4 / 5
Distinctiveness Conflict Risk	"WCAG 2.2 accessibility audits" carves out a clear niche with distinct triggers (WCAG violations, accessibility audits) and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (556 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: Dicklesworthstone/pi_agent_rust
Path: tests/ext_conformance/artifacts/agents-wshobson/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md
Commit: 6453c0b

Reviewed: about 10 hours ago

Table of Contents

Discovery Implementation Validation

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.