# responsive-qa
A skill for Claude Code, Codex and other coding agents. It tests your web pages in a real browser at phone, tablet and desktop sizes, with touch turned on and on a slow 3G connection. Then it fixes what looks broken, one small fix at a time, with a before and after screenshot for each.
## Install
```bash
npx skills add mkmaker/responsive-qa
```
The installer asks which agent to add it to.
Or with git, for Claude Code:
```bash
git clone https://github.com/mkmaker/responsive-qa ~/.claude/skills/responsive-qa
```
## Use
Start your project's dev server, then tell your agent:
> responsive qa on the sign-up page
Other phrases that trigger it: "test on phones", "test at different widths", "slow 3G test", "mobile check".
## What it checks
- Sideways scrolling and things that stick out of the screen
- Text that is cut off
- Buttons and links too small to tap
- Things hidden under a fixed top or bottom bar
- Desktop-only hints shown on touch devices
- Load time and the heaviest files on Slow 3G and Fast 3G
Sizes covered: 280 to 1920 wide, plus a phone held sideways and a short window.
## Needs
Node and Puppeteer. If Puppeteer is missing, the skill tells the agent to run `npm i puppeteer` in a scratch folder. To use your installed Chrome, set `CHROME_PATH`.
## Licence
MIT