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.
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.md2
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.md7
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 German55
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 GermanWhat 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 GermanIts 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.
- Native HTML semantics
- Browser/OS features
- CSS
- ARIA
- JavaScript
- Accessibility preferences
- 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.
$ npx cg-web-skills@latest install cg-web-accessibility