/coleoni-a11y

Everyone can use it. Now you can prove it.

The skill checks a site the way people with disabilities use it: on a keyboard, with a screen reader, with low vision, zoomed in, sensitive to motion. Every problem comes cropped from the page, mapped to WCAG 2.2 and to the Brazilian eMAG, with who it blocks and how to fix it.

npx skills add c0le0ni/skills --skill coleoni-a11y
View on GitHub
Claude Code, Codex and more WCAG 2.2 AA and eMAG 3.1 Keyboard walk on every page Report in English or Portuguese
The accessibility report of a bakery site, in a browser and on a phone The same report in Portuguese, with the eMAG names Each problem cropped from the page and outlined The report on three phones This site after the fixes: no problems, every page with a skip link
Example

This site failed its own audit. Then it passed.

We ran the skill on skills.coleoni.com. The faint grey text failed contrast on every page, the language button hid its label, and there was no skip link. A token, an attribute and one link later: zero.

a11y.json
skills.coleoni.com, before the audit

  color-contrast          268 elements
    #707070 on #111111 = 3.81:1  (needs 4.5)
  label-content-name      16
    "EN" missing from the button's name
  scrollable-region       4
    code boxes the keyboard can't reach
  skip link               none on 16 pages

after: 0 problems · 52 rules passed
268contrast failures, fixed with 1 token
16pages with a skip link now
52rules passing
0problems left in the automated pass
How it works

The rule engine, then the keyboard, then a person.

Automated rules find part of the problems. The skill adds the checks a rule engine skips, and then does the manual pass a script can’t.

  1. Runs axe-core

    WCAG 2.0, 2.1 and 2.2, levels A and AA, plus best practices, on every page from the sitemap.

  2. Walks with the keyboard

    Tab through every page: is focus visible, does it fall on hidden things, does it get stuck, is there a skip link.

  3. Zooms and calms down

    Reflow at 320px, the 400% zoom test, and animations that keep running with reduced motion on.

  4. Crops every problem

    Each failing element cut from the page and outlined, so the team sees it without hunting.

  5. Maps to WCAG and eMAG

    Every problem with its WCAG 2.2 criterion and its eMAG 3.1 recommendation, in English or Portuguese.

  6. Fixes, if you ask

    Tokens before components, native elements before ARIA, and the audit again to show the new count.

Who it protects

Each problem, and who it blocks.

A sample of what the report finds, with the criteria it cites.

ProblemWho it blocks · WCAG · eMAG
Low contrast textLow vision, bright sun · 1.4.3 · 4.1
No visible focusKeyboard users · 2.4.7 · 4.4
Button or link without a nameScreen readers · 4.1.2 · 2.2, 3.5
Image without alt textScreen readers · 1.1.1 · 3.6
Field without a labelScreen readers, voice control · 3.3.2 · 6.2
Page scrolls sideways at 320pxZoom users · 1.4.10 · 4.3
No skip linkKeyboard users · 2.4.1 · 1.5
Animation ignores reduced motionVestibular disorders · 2.3.3 · 5.5
Install

One command, any agent.

The packages are axe-core and playwright-core, installed by the agent on first use. It drives the Chrome or Edge you already have.

AgentClaude Code, Codex, Cursor…
Node.js18 or newer
Chrome or Edgealready on the machine
01Install
npx skills add c0le0ni/skills --skill coleoni-a11y
02Use it in your agent
/coleoni-a11y https://yoursite.com
For your whole user, not just the project-g
Claude Code only-a claude-code
Codex only-a codex
Every Coleoni skillnpx skills add c0le0ni/skills
Examples

Before launch, or before the client asks.

It shows the report first. Code changes only when you say so.

Audit the live site.

/coleoni-a11y https://yoursite.com

A Brazilian client, report in Portuguese.

/coleoni-a11y https://site.com.br --lang pt

Fix the build before deploy.

/coleoni-a11y ./dist, fix the contrast and the focus
Options

The engine, from the terminal.

scripts/a11y.mjs runs on its own too: node a11y.mjs https://yoursite.com --out a11y-report.

OptionWhat it does
<url | folder>A live site, a dev server or a build folder served on a temporary port
--lang en|ptReport language; Portuguese uses the eMAG names and axe in Portuguese
--pages 10Most pages to audit, from the sitemap or the links
--domain site.comName in the report, for local builds
--no-keyboardSkip the Tab walk

Built for everyone. Checked for everyone.

npx skills add c0le0ni/skills --skill coleoni-a11y