# ecom-a11y-audit

> Audits a Shopify store for WCAG 2.2 AA and says who can fix each issue: the theme, the app that injected it, or the clash between them.

ecom-a11y-audit is Kurt Elster's community skill for accessibility audits of Shopify storefronts. Point your agent at a store and it returns a prioritized WCAG 2.2 AA findings report, with every finding attributed to the party that can actually fix it: the theme, the app that injected the markup, or a collision between them.

What you can do with it
- Audit a store by sampling one page per theme template (home, product, collection, article, content page and cart), picking the most app-heavy product page
- Scan with axe-core and HTML_CodeSniffer through pa11y, plus an optional Lighthouse score
- Re-measure color contrast after animations settle, so fade-in effects don't produce false failures
- Check what scanners can't: alt text quality, useless link names, semantic HTML and readability
- Tab through the storefront in a driven browser to find focus traps, invisible tab stops, missing skip links and reflow problems at 320px
- Get fix routes per app (Rebuy, Okendo, Klaviyo, Judge.me, Yotpo and more): widget settings, or a support ticket to forward
- File one tracker task per grouped finding on request (ClickUp via MCP in the reference flow)

How it connects
- Install it as a Claude Code plugin from the maker's own marketplace, or with npx skills add for other agents.
- Its scan script runs pa11y and Lighthouse through npx and needs Node.js, Chrome or Chromium, and Python 3.
- The interactive pass drives the store through Claude in Chrome or Playwright.
- It works on password-protected dev stores and unpublished theme previews.

Good to know
- Shopify storefronts only: it checks the target is Shopify before scanning. Checkout is Shopify-hosted and reported as out of scope.
- It never claims compliance from a clean scan: criteria it didn't exercise are reported as Undetermined, and each finding is graded for evidence as well as severity.
- It recommends fixes with concrete values but doesn't edit code unless you ask separately.
- It keeps storefront fetches to a handful of pages.

- Type: Skill
- Made by: kgelster
- Category: E-commerce
- Formats: Skills
- Version: 0fc9b2a
- Source: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit
- Page: https://pluginboard.ai/skills/ecom-a11y-audit

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the a11y-audit folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Claude

In Claude (web or desktop): Download the a11y-audit folder and zip the folder itself, then upload it in Customize → Skills.

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Gemini

In Gemini: Download the a11y-audit folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### GitHub Copilot

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.copilot/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Cursor

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.cursor/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Claude Code

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.claude/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

Or as a Claude Code plugin:

```text
/plugin marketplace add kgelster/ecom-a11y-audit
/plugin install a11y-audit@kgelster-a11y
```

### Codex

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.agents/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Antigravity

In Antigravity: Copy the a11y-audit folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Gemini CLI

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.gemini/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Replit

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit .agents/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### OpenClaw

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.openclaw/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### OpenCode

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.config/opencode/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

### Hermes Agent

Run in your terminal:

```shell
npx -y degit kgelster/ecom-a11y-audit/skills/a11y-audit ~/.hermes/skills/a11y-audit
```

View the folder on GitHub: https://github.com/kgelster/ecom-a11y-audit/tree/HEAD/skills/a11y-audit

---
From Pluginboard (https://pluginboard.ai).
