a11y-agent-skills: skill pack for Hermes Agent

Accessibility skills, CLI, MCP server and GitHub Action for agent-assisted audits and fixes

What a11y-agent-skills does

Twelve portable Agent Skills guide coding agents through reproducible evidence, conservative source fixes, scoped verification and durable regression tests, while framework-independent Playwright and axe-core packages provide the deterministic core. React is the first tested framework fixture. The a11y-agent CLI offers doctor, scan and verify commands, and an MCP server runs over stdio.

A typical flow has the agent run accessibility-audit to save JSON evidence for a page state, then fix-accessibility-issue to locate the source, make the smallest supported repair, replay the state and add the narrowest regression test. A verify run compares against the saved baseline and records state reproduction, resolved and remaining fingerprints, new serious or critical findings and exact run IDs. Version 0.2.0 added five specialist skills, such as accessible-authentication and accessible-data-tables-and-grids. The README gives install steps for Codex, Claude Code and Cursor, and says generic Agent Skills hosts can point at the skills/ folder.

Key features

Twelve portable Agent Skills for audits, fixes and regression tests
a11y-agent CLI with doctor, scan and verify commands
Stdio MCP server published as @a11y-agent/mcp
Deterministic Playwright and axe-core core packages
Verification reports with resolved and remaining fingerprints
Specialist skills for authentication, data tables and grids

When to use it

Auditing a checkout page state and saving JSON evidence
Having an agent repair an accessibility issue and prove the fix
Adding narrow accessibility regression tests to a React project

Who it is for: Teams building web interfaces with AI coding agents who want repeatable accessibility checks and fixes.

How it fits with Hermes Agent

The repository is tagged hermes-agent. Its skills follow the Agent Skills specification at agentskills.io, and the MCP server speaks stdio.

How to install a11y-agent-skills

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npx --yes playwright@1.58.0 install chromium
npx --yes @a11y-agent/cli doctor
npx --yes @a11y-agent/cli scan https://example.com
npx --yes @a11y-agent/mcp

Requirements: Node.js 20+ for the published core, CLI and MCP packages; building from source needs Node.js 22.13+ and pnpm 11.19

FAQ

What is a11y-agent-skills?

a11y-agent-skills is an accessibility toolkit for AI-assisted development. It combines twelve Agent Skills, a CLI, an MCP server and a GitHub Action to find, fix and verify accessibility issues.

Does a11y-agent-skills work with Hermes Agent?

Likely yes, as a general Agent Skills package. The repository is tagged hermes-agent, its skills follow the agentskills.io specification, and the README says generic hosts can point at the skills/ folder.

What do I need to run a11y-agent-skills?

You need Node.js 20 or newer for the published CLI and MCP packages. Building from source needs Node.js 22.13 or newer and pnpm 11.19.