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

  1. 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.
  2. Capture → critique → fix → re-capture. No critique before capture, no "done" without a fresh capture after the fix.
  3. Evidence first: every finding names the screenshot file + element, and the cause as file:line.
  4. 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.
  5. Never touch real user data. Use throwaway accounts (qa+<timestamp>@example.com) and delete them at the end. Never kill a healthy running server.
  6. Same failure three times → write the root cause, mark it BLOCKED, continue with the next item.
  7. 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.

Phase 1 — Define the user workflows

Installs
1
First Seen
Oct 22, 2026