CG Web Skills

Accessibility engineer

cg-web-accessibility

It works on two levels that always belong together: accessible source code first, and a toolbar for personal preferences on top. The toolbar is never the fix.

6,875 words of method · Documented for version 1.2.1 · checked

Read the full SKILL.md

1

Native HTML first, ARIA last

A button is a <button>, a link is an <a href>, a field has a <label>. The skill sets an order of preference — native semantics, browser features, CSS, and ARIA only where native semantics are not enough — and forbids ARIA that papers over the wrong element.

No ARIA is better than bad ARIA.

cg-web-accessibility · SKILL.md

2

A toolbar is not compliance

An accessibility widget can offer preferences such as larger text or reduced motion. It cannot write correct alt text, fix the focus order or make a checkout usable with a screen reader. So Claude always remediates the source and treats the toolbar as an additional layer.

Accessibility by source + Accessibility preferences on top.

cg-web-accessibility · SKILL.md

7

A toolbar where every switch works

A real button on every page opens an accessible dialog: larger text, text spacing, line height, contrast modes, highlighted links, paused animations, hidden images, a reading-friendly font, a larger cursor, a page structure navigator and a reset. Preferences are stored locally only — no external service, no tracking, no personal data.

Every feature must actually work.

cg-web-accessibility · SKILL.md · translated from German

55

Tested with real tools, not only scanners

Automated scans with axe or Lighthouse catch part of the problems. The skill adds a keyboard pass, at least one real screen reader, a mobile pass and a 200 % text-size pass, and checks every toolbar mode against the rest of the page.

Accessibility must be tested with a combination of automated and manual methods.

cg-web-accessibility · SKILL.md · translated from German

What it refuses to claim

The skill is explicit that a button in the corner is not a legal status — not for WCAG, not for EN 301 549 and not for Germany's BFSG:

Never claim that the toolbar alone establishes WCAG, EN 301 549 or BFSG conformance.

cg-web-accessibility · SKILL.md · translated from German

Its order of preference

Solve it with native HTML where possible, reach for ARIA and JavaScript only when needed, add preferences on top, and verify with real assistive technology at the end.

  1. Native HTML semantics
  2. Browser/OS features
  3. CSS
  4. ARIA
  5. JavaScript
  6. Accessibility preferences
  7. Tests with assistive technology

Try asking Claude

  • Make our website accessible and add an accessibility button.
  • Check this site against WCAG 2.2 AA and fix what you find.
  • Our online shop falls under the BFSG. What do we need to fix?
  • The mobile menu isn't usable with a keyboard. Fix it.
Terminal session
$ npx cg-web-skills@latest install cg-web-accessibility