web-accessibility-audit
Audit web applications for WCAG accessibility compliance. Use when asked to run accessibility checks, identify common violations, and provide remediation guidance.
Install with Tessl CLI
npx tessl i github:warpdotdev/oz-skills --skill web-accessibility-audit87
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
N/ABased on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
Something went wrong
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, comprehensive accessibility auditing skill with excellent actionability and workflow clarity. The 4-phase audit process is well-defined with concrete tools and commands. Minor verbosity in explaining WCAG fundamentals (POUR principles, conformance levels) that Claude already knows could be trimmed to improve token efficiency.
Suggestions
Remove or significantly condense the WCAG Principles (POUR) and Conformance Levels sections - Claude knows these fundamentals and they consume tokens without adding actionable value.
Consider moving the '12 Most Common WCAG Violations' detailed list to a reference file, keeping only a brief summary in the main skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some content Claude already knows (WCAG principles table, conformance levels explanation). The WebAIM statistics and violation percentages add value, but the POUR principles and level definitions are basic knowledge that could be trimmed. | 2 / 3 |
Actionability | Excellent executable guidance throughout - concrete bash commands for ESLint and Lighthouse, complete HTML/CSS/JS code examples showing before/after patterns, and specific grep pattern references. All code is copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear 4-phase audit process with explicit sequencing (automated → manual inspection → analyze/prioritize → manual testing). Severity-based prioritization provides clear decision framework. The output format section provides a complete template for deliverables. | 3 / 3 |
Progressive Disclosure | Well-structured with clear navigation to external references (grep-patterns.md, screen-reader-guide.md, WCAG-criteria.md, ARIA-patterns.md). Content is appropriately split between overview in main file and detailed materials in references. One-level-deep linking throughout. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
87%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 14 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 14 / 16 Passed | |
- 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.