← ClaudeAtlas

bug-reportinglisted

Load this skill whenever you are filing, reviewing, or generating accessibility bug reports — whether from automated tool output, manual testing, or AI agent scans. The purpose of this skill is to make accessibility errors easier to report accurately, so that developers can reproduce, understand, and fix them without additional back-and-forth. Absolutely always include the required fields (URL, XPath, HTML snippet, WCAG SC, rule ID, severity, frequency) in every report. Under no circumstances file a vague report that omits the failing element, the WCAG criterion, or the steps to reproduce.
mgifford/accessibility-skills · ★ 15 · Data & Documents · score 77
Install: claude install-skill mgifford/accessibility-skills
# Accessibility Bug Reporting Skill > **Canonical source**: `examples/ACCESSIBILITY_BUG_REPORTING_BEST_PRACTICES.md` in `mgifford/ACCESSIBILITY.md` > This skill is derived from that file. When in doubt, the example is authoritative. Apply these rules when filing, reviewing, or generating accessibility bug reports from any source — automated tool output, manual testing, or AI agent scans. --- ## Core Mandate **Reproducibility is the single most important quality of a bug report.** If a developer cannot reproduce the problem, they cannot fix it. Every report must give enough information for a developer who was not present during testing to reproduce, understand, and fix the problem without additional back-and-forth. --- ## Severity Scale (this skill) | Level | Meaning | Action | | --- | --- | --- | | **Critical** | Users cannot complete a core task at all | Must fix before release | | **High** | Significant barrier that degrades or blocks a key workflow | Fix urgently | | **Medium** | Noticeable barrier with a workaround available | Fix in near-term backlog | | **Low** | Minor issue with minimal real-world impact | Fix when convenient | --- ## Critical: Required Fields Every accessibility bug report **must** include all eight of the following fields. **Omitting any required field is Critical** — the report cannot be acted on. ### 1. Page URL Provide the exact URL where the issue was found, including query string and fragment identifier if relevant. ``` URL: https