issue-reporting-remediation

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