| name | icons-qa |
| description | Runs visual and structural QA for this repository's Stream Deck icons. Use after icon or build changes, or when asked to inspect, review, dogfood, or visually validate icon assets, paired states, the 5 x 3 preview, browser rendering, responsive behavior, or icon accessibility. |
Icons QA
Validate generated assets first, then inspect the rendered deck with the repo-local agent-browser. Treat AGENTS.md and config/icons.json as the expected-result contract. Report issues; do not edit icons unless the user also asks for fixes.
Preconditions
-
Run from the repository root.
-
Run pnpm install when dependencies are missing.
-
Run pnpm browser:install when the browser is missing or pnpm exec agent-browser doctor --offline --quick reports a browser problem.
-
Load the installed CLI guidance before driving the browser:
pnpm exec agent-browser skills get core
pnpm exec agent-browser skills get dogfood
Use pnpm exec agent-browser for every browser command. Do not use npx or assume a global installation.
Workflow
-
Read AGENTS.md and config/icons.json. Note the configured icon names, state pairs, palette, layer order, sizes, and offsets.
-
Run pnpm build and pnpm check. Fix build or validation failures only when fixes are in scope; otherwise report them and stop visual QA if the preview assets are unavailable or stale.
-
Start in a persistent shell and wait for . Keep that process alive. If the port belongs to an unrelated process, do not terminate it; start this server on a free port and use that URL consistently.
