cli-audit

# CLI Audit Skill Use this skill when asked to audit a live URL from Claude CLI. Respect robots directives and site terms of service for every live-site audit request. ## Required Execution When the user asks to audit a page URL, run: ```bash npx --yes --package=github:mgifford/accessibility-skills cli-audit-inspect <URL> ``` This invocation is portable for Claude CLI users because it pulls the inspection command from this repository package instead of requiring a local `scripts/` file in the target project. ## Be Polite With Live Sites When auditing live URLs, keep behavior respectful and low impact: - Prefer single-page or small-batch checks first. - Avoid rapid repeated scans against production pages. - If Cloudflare/WAF blocks requests, do not brute-force retries. - Recommend owner-approved alternatives: staging URLs, allowlisting, or manual checks. ## Required Parsing Parse the emitted JSON and evaluate: 1. `axe.violations` for automated WCAG and best-practice failures. 2. `axe.incomplete` for potential violations that need manual confirmation. 3. `accessibilityTree` for behavioral issues that automated rules miss, including: - Missing or unclear names for interactive elements - Unexpected roles or role mismatches - Landmark and heading structure problems - State communication gaps (`expanded`, `checked`, `selected`, disabled state) - Dialog and menu semantics that can indicate focus-management risk ## Required Evaluation Method Map findings ...