# accessibility-scan

Scans one live page for mechanically detectable WCAG 2.2 issues and reports their DOM locations. Run it after a UI change to review the page.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 114
- Author: AccessLint
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AccessLint/skills/tree/HEAD/plugins/accesslint/skills/accessibility-scan/SKILL.md
- Updated: 2026-08-25
- HTML: https://affpapa.org/en/nevibecode/skills/accessibility-scan

## What it does

The skill runs `@accesslint/core` against a live page over CDP. Its report groups findings by impact and gives a DOM selector; when source mapping is available, it also points to a file and line. Evidence can include a contrast ratio or a missing attribute.

Before scanning, the skill ensures Chrome is available for debugging. Give it a page URL, a target name from `accesslint.config.json`, or no argument to use the config’s default target. If there is no default target or config file, provide a URL.

It reports findings without editing the project. After making fixes, run the scan again to check the page. Keyboard and screen-reader checks are handled by the separate `accessibility-inspect` skill, not this scan.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add AccessLint/skills --skill accessibility-scan -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/accessibility-scan/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/accessibility-scan/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add AccessLint/skills --skill accessibility-scan -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/accessibility-scan/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add AccessLint/skills --skill accessibility-scan -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/accessibility-scan/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AccessLint/skills accessibility-scan
```

2. **Manually: put the files in place**
- File: `.github/skills/accessibility-scan/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add AccessLint/skills --skill accessibility-scan -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/AccessLint/skills --path plugins/accesslint/skills/accessibility-scan
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/accessibility-scan/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add AccessLint/skills --skill accessibility-scan -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/AccessLint/skills/tree/HEAD/plugins/accesslint/skills/accessibility-scan/SKILL.md

## When to use it
- find WCAG 2.2 issues on a live page
- locate a finding by DOM selector and source line
- check for contrast and missing-attribute problems
- rescan a page after a UI change

## Example prompts
- Scan the `dev` target for accessibility issues and list the findings.
- Check this page and connect each issue to its selector and source file when available.
- Scan the page at the URL I provide; report findings without editing code.

## Similar
- [web-perf](https://affpapa.org/en/nevibecode/skills/cloudflare-web-perf.md) — skill · 110200 installs
- [mobile-native](https://affpapa.org/en/nevibecode/skills/mobile-native.md) — skill · 86600 installs
- [browser-testing-with-devtools](https://affpapa.org/en/nevibecode/skills/browser-testing-with-devtools.md) — skill · 58600 installs
- [stitch-loop](https://affpapa.org/en/nevibecode/skills/stitch-loop.md) — skill · 56400 installs
- [baoyu-markdown-to-html](https://affpapa.org/en/nevibecode/skills/baoyu-markdown-to-html.md) — skill · 32200 installs
- [clerk](https://affpapa.org/en/nevibecode/skills/clerk.md) — skill · 30000 installs

From the same set: [accesslint/skills](https://affpapa.org/en/nevibecode/by/accesslint/skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md