Skip to content
SkillMixed1,676 tokens in use

accessibility-engineering

Audit a built interface for WCAG 2.2 AA with axe-core, pa11y and manual checks, then fix each verified violation.

119,377 stars on the repository MIT Licenseaddyosmani/agent-skills · skills/accessibility-engineering
npx skills add addyosmani/agent-skills --skill accessibility-engineering
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing accessibility-engineering costs

62tokens idle
1,676tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/audit-a11y.sh.

Touches

shelldetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure23/25
  • Examples6/15
  • Output15/15
  • Size13/15
  • Resources0/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 34
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/audit-a11y.sh, line 40

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community76
  • Maturity32
  • Momentum40

Accessibility Engineering guides an agent through auditing an existing page or component for WCAG 2.2 AA conformance. It runs pinned axe-core and pa11y scans, adds keyboard, screen reader and visual checks by hand, and remediates each verified violation.

The skill treats automated results as a smoke test. A finding is confirmed in the browser before it is fixed, and the root cause in the markup is fixed before any ARIA is added.

What You Get

  • A four-phase workflow: route new UI work elsewhere, run automated audit, test manually, fix violations
  • A script that merges axe-core and pa11y results into one JSON report grouped by severity
  • A manual checklist covering keyboard, screen reader, contrast, zoom, forced colors and focus visibility
  • A verification checklist to confirm the work is finished

Common Use Cases

  • Auditing a page before a release
  • Triaging axe-core or pa11y output
  • Fixing reported keyboard or screen reader problems
  • Checking color contrast and touch target size

What Makes It Unique

The skill is scoped to auditing and remediation of existing interfaces and sends construction work to the frontend-ui-engineering skill. Its script pins tool versions and exits with an error when a scan fails, so a partial run is never reported as a clean pass. It also states that screen reader checks must name a browser and assistive technology pair or be recorded as untested.

Under The Hood

The SKILL.md loads when an accessibility audit is requested. The agent runs npx to fetch pinned versions of @axe-core/cli and pa11y and points them at a URL, usually a local dev server, which needs network access. The audit-a11y.sh script writes reports to a temporary folder, parses them with node and prints structured JSON. The skill links to a shared accessibility checklist and an auditor persona in the repository.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers