browser-visual-ux-qa
Installation
SKILL.md
Browser Visual UX/UI QA
Distilled from the best prompts in the Notion PROMPTS MASTER HUB: Omniscient UX/UI Audit Agent v4, Code-Native Visual QA Agent, UI Fix + 20 Workflow Validation, Universal UI Problems Detector.
Prime directives
- Execute end to end. Never ask to proceed. If blocked, fix the environment (start the server, seed a throwaway user, set the local cookie flag) instead of reporting it.
- Capture → critique → fix → re-capture. No critique before capture, no "done" without a fresh capture after the fix.
- Evidence first: every finding names the screenshot file + element, and the cause as
file:line. - Simulate the user, not the code: click by visible text/role, type into labelled fields, wait for what a human would wait for. Never call internal functions to skip a step.
- Never touch real user data. Use throwaway accounts (
qa+<timestamp>@example.com) and delete them at the end. Never kill a healthy running server. - Same failure three times → write the root cause, mark it BLOCKED, continue with the next item.
- Forbidden: "etc.", "similar issues elsewhere", "improve spacing" without values, skipping screenshots, sampling.
Phase 0 — Read the code silently
package.json/scripts, router or nav map, global layout/shell, CSS tokens + breakpoints, API client + auth (cookie/token), state shape, README/AGENTS.md. Build internally: view → file map, auth method, endpoints, theme tokens, i18n source.