responsive-review
Installation
SKILL.md
Responsive Accessibility Review
Test whether an interface maintains accessibility across the full range of screen sizes, zoom levels, and orientations that real users encounter.
Process
Step 1: Viewport Testing
Test the interface at these viewport widths:
- 320px (small mobile)
- 375px (standard mobile)
- 768px (tablet)
- 1024px (small desktop / tablet landscape)
- 1280px (standard desktop)
- 1440px+ (large desktop)
At each viewport, using responsive-accessibility, document:
- Content that overflows or is hidden
- Interactive elements that are unreachable
- Touch targets below 44×44px on touch viewports
- Navigation that doesn't adapt
- Functionality that disappears entirely
Step 2: Zoom Testing
At 1280px viewport, test at:
- 100% (baseline)
- 150% (common for low vision users)
- 200% (WCAG requirement)
Document:
- Horizontal scrolling that appears
- Text that overflows containers
- Overlapping elements
- Sticky headers that consume excessive space
- Modals or tooltips that go off-screen
Step 3: Typography Scaling
Using flexible-typography, test with system font size at maximum. Document:
- Text that doesn't scale
- Containers that clip or truncate text
- Layout that breaks when text grows
- Fixed-height elements that don't expand
Step 4: Orientation Testing
Test in both portrait and landscape. Document:
- Content that only works in one orientation
- Orientation lock that prevents rotation
- Layout that breaks or wastes space in one orientation
Step 5: Density Check
Using information-density, at each viewport verify:
- Is the default density appropriate for the device?
- Can users adjust density?
- Does compact density maintain minimum touch targets?
- Does spacious density work without excessive scrolling?
Output
Deliver a responsive accessibility report:
- Viewport matrix — pass/fail at each viewport width for core tasks
- Zoom results — issues at 150% and 200%
- Typography results — text scaling failures
- Orientation results — portrait/landscape issues
- Fix list — prioritised by severity, grouped by:
- Fixes that affect all viewports
- Fixes specific to mobile
- Fixes specific to zoom