# Accesslint Scan

Audit a live page for accessibility issues, locate each WCAG violation precisely, and...

- Repository: https://github.com/sickn33/agentic-awesome-skills (48984 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add sickn33/agentic-awesome-skills --skill accesslint-scan -g -a claude-code -y`
Codex: `npx skills add sickn33/agentic-awesome-skills --skill accesslint-scan -g -a codex -y`
Cursor: `npx skills add sickn33/agentic-awesome-skills --skill accesslint-scan -g -a cursor -y`
Gemini CLI: `npx skills add sickn33/agentic-awesome-skills --skill accesslint-scan -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add sickn33/agentic-awesome-skills`

## Description

Audit a live page for accessibility issues, locate each WCAG violation precisely, and return a selector-grounded fix worklist without editing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Audit a live page and report what's broken and where. Locate; don't fix. If no URL in `$ARGUMENTS`, ask for one.

## When to Use
- A supplied page needs an automated contrast, accessible-name, or semantic-markup audit.
- You need selector-grounded findings after a UI change, without modifying the application.
- Manual assistive-technology checks or site-wide conformance assessment are separate work.

## 1. Audit

Use an already reviewed, project-pinned installation of `@accesslint/chrome` and
`@accesslint/cli`; confirm their local binaries and CLI help before execution.
Do not silently download and execute `@latest`. Confirm the URL and whether
browser access could expose authenticated or sensitive content.

For a project whose locked installation exposes these binary names:

```bash
session_file="$(mktemp)"
./node_modules/.bin/accesslint-chrome ensure > "$session_file"
```

Read the complete JSON result once, record `port` and `managed`, and substitute
the returned port in `./node_modules/.bin/accesslint scan "<target>" --port "<returned-port>" --format json`. Never parse arbitrary
stdout chunks as complete JSON. Confirm the actual binary names from the
installed packages; they may differ by version. The current upstream command
shape is `scan <target> --port <port> --format json`.


Flags as needed: `--selector`, `--wait-for "<selector>"`, `--include-aaa`, `--disable <rules>`.

## 2. Report

Counts by impact, then one entry per violation:

- **where**, selector verbatim + `file:line (symbol)` if `source` is present, never fabricate. If no violation has `source`, note "source mapping unavailable, located by selector only".
- **evidence**, contrast ratio, missing attribute, empty name
- **fix**, mechanical change or `NEEDS HUMAN`

Return the worklist without editing. Remediation requires a separate authorized task; current upstream names it `accesslint:accessibility-fix`, which may not be installed in this host.

## 3. Tear down

The rest: https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/plugins/agentic-awesome-skills-claude/skills/accesslint-scan/SKILL.md