Agent skill

a11y-auditor

Audit web pages for accessibility issues in a real browser. Checks contrast, font sizes, focus indicators, keyboard navigation, ARIA labels, and semantic HTML against WCAG 2.1 AA. Reports findings with screenshots and specific remediation steps. Requires the hanzi browser automation MCP server and Chrome extension.

View SKILL.md on GitHub Repository
Stars 148
Forks 42

Install this agent skill to your Project

npx add-skill https://github.com/hanzili/hanzi-browse/tree/main/server/skills/a11y-auditor

SKILL.md

Accessibility Auditor

You audit web pages for accessibility issues using a real browser — real contrast, real tab order, real focus indicators, real screen reader semantics. This skill is read-only: observe and report, don't modify.

Tool Selection Rule

  • Prefer existing tools first (code search, local files). Review ARIA usage and semantic HTML before opening the browser.
  • Use Hanzi only for browser-required steps: visual checks, keyboard navigation, focus behavior.

Before Starting

Call browser_status to verify the extension is reachable. If unavailable, tell the user to install from: https://chromewebstore.google.com/detail/hanzi-browse/iklpkemlmbhemkiojndpbhoakgikpmcd

What You Need

  1. URL — page or site to audit 2. Scope — single page, flow, or full site 3. Standard — defaults to WCAG 2.1 AA

Audit Phases

Phase 1 — Codebase Review (before browser): Scan for ARIA usage, semantic HTML (<div> vs <button>/<nav>/<main>), image alt text, form labels, heading hierarchy. Summarize before opening browser.

Phase 2 — Visual (browser): Check color contrast (4.5:1 normal, 3:1 large text), font sizes (min 12px), focus indicators (tab through page), touch targets (24×24px min), motion/animation. Screenshot each area.

Phase 3 — Keyboard (browser): Test tab order, focus traps in modals/dropdowns, keyboard operability (Enter/Space), skip links. Screenshot problematic focus states.

Phase 4 — ARIA & Semantics (browser): Verify landmarks, form label associations, dynamic content announcements (aria-live), image/icon accessible names, table headers.

Report Format

Categorize issues as Critical / Serious / Moderate / Minor with: element/location, impact, WCAG criterion, specific fix, screenshot. List passing checks. For each issue with source access, include file, specific fix, and complexity estimate. End with severity totals and top 3 priorities.

Rules

  • One page/flow at a time — screenshot every issue found
  • Be specific ("the search button" not "a button") and cite WCAG criteria (e.g., 1.4.3)
  • Don't report unverified issues — if unsure, say so
  • If browser_start times out, call browser_screenshot to diagnose

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

hanzili/hanzi-browse

apartment-finder

148 42
Explore
hanzili/hanzi-browse

data-extractor

148 42
Explore
hanzili/hanzi-browse

seo-checker

Audit web pages for SEO issues in a real browser. Checks rendered meta tags, heading hierarchy, image alt text, structured data, canonical URLs, mobile rendering, and performance signals. Produces a scored report with specific findings and fixes. Read-only — inspects, doesn't modify. Requires the hanzi browser automation MCP server and Chrome extension.

148 42
Explore
hanzili/hanzi-browse

linkedin-prospector

Find people on LinkedIn and send personalized connection requests. Supports multiple strategies based on goal — networking (search posts), sales (search by role/company), partnerships (combine both), hiring (search by skills), or market research (analyze posts + comments). Each connection note is unique and personalized. Requires the hanzi browser automation MCP server and Chrome extension.

148 42
Explore
hanzili/hanzi-browse

competitor-monitor

Monitor competitor websites for changes. Visit a list of URLs, extract pricing, features, positioning, and key content, compare against previous snapshots stored locally, and generate a change report summarizing what's different. Use when the user says "check competitors", "what changed on their site", "monitor these URLs", or wants periodic competitive intelligence. Requires the hanzi browser automation MCP server and Chrome extension.

148 42
Explore
hanzili/hanzi-browse

x-marketer

Professional X/Twitter growth skill. Finds high-value conversations, builds warm engagement, and posts contextual replies from your real signed-in account. Supports three modes — reply-to-conversations (find pain points + reply), engage-influencers (warm up large accounts), and monitor-brand (track mentions + respond). Thinks like a specialist X marketer, not a bot. Requires the hanzi browser automation MCP server and Chrome extension.

148 42
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results