ui-checklisted
Install: claude install-skill stxrmik/antigravity-plus
# /ui-check — see the page, phone and desktop
Helper: `python3 "<skill_dir>/scripts/ui_check.py"`. It runs headless Chrome (or Chromium, Brave, Edge) with a
throw-away profile, so it needs `BypassSandbox: true`. It doesn't touch the user's browser.
## Steps
1. **Find the URL.** An app (React, Vue, a Python backend with templates) needs its running dev server:
`http://localhost:<port>/…`. Start it the project's way (`AGENTS.md`, `package.json`, compose) if it isn't
running, and stop it afterwards if you started it. A static page can be opened as a file.
2. **Run** for the pages you changed:
```bash
python3 "<skill_dir>/scripts/ui_check.py" "<url or file>" --widths 390,1440 --scan "<folder with the front-end code>"
```
`390` is an iPhone, `1440` a laptop. Add `768` for a tablet layout.
3. **Look at every screenshot** (read_file on each PNG): layout, cut-off or overlapping blocks, horizontal overflow,
text size, tap targets, empty or broken areas. A blank page means the app didn't load: check the URL and the
console errors.
4. **Console errors** from the report: fix the ones your change caused.
5. **Performance**, when the page is slow, heats the phone or scrolls badly: go through the `--scan` list. The usual
fixes are dropping or narrowing `backdrop-filter` and big blurs, pausing animations off-screen
(`IntersectionObserver`) or for `prefers-reduced-motion`, replacing `background-attachment: fixed` with a fixed
pseudo-element, and stopping can