| name | issue-reporting-remediation |
| description | Use when documenting accessibility issues, writing remediation guidance, prioritizing fixes, or translating audit findings into actionable engineering/design work. |
Issue Reporting & Remediation
Use this skill when turning accessibility findings into clear, actionable guidance. Focus on making issues understandable, reproducible, and fixable by design and engineering teams.
Report Clearly
- Describe the issue, who it affects, and why it matters
- Include steps to reproduce, expected behavior, and actual behavior
- Reference relevant WCAG criteria or platform guidance when helpful
- Avoid vague labels like “accessibility issue” without context
Make Fixes Actionable
- Suggest likely causes and practical remediation options
- Separate design, content, and implementation concerns where relevant
- Prioritize by user impact and task criticality
- Call out dependencies, regressions, or related patterns that should be reviewed
Output
- Provide concise issue statements with remediation guidance
- Organize by severity or workflow where useful
- Make recommendations easy to hand off into tickets or pull requests
