icons-qa

Validates Stream Deck icon assets and inspects the browser preview for visual and structural issues.

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/dcramer/streamdeck-icons --skill icons-qa-dcramer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: icons-qa
Source: https://github.com/dcramer/streamdeck-icons/tree/main/.agents/skills/icons-qa
Command: npx skills add https://github.com/dcramer/streamdeck-icons --skill icons-qa-dcramer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually checking whether generated Stream Deck icons render correctly, stay aligned, and follow the project's palette and state conventions is slow and error-prone. This Skill runs a repeatable QA workflow that builds the assets, launches the 5 x 3 deck preview, and inspects it in a real browser at desktop and narrow viewports. ## Core Features & Use Cases - Build and asset validation: Runs pnpm build and pnpm check to confirm generated SVG and PNG icons are fresh and structurally valid before visual review. - Browser-based visual inspection: Uses the repo-local agent-browser CLI to screenshot the preview, verify all 15 keys render, check image loading, console errors, and accessibility attributes. - Icon convention checks: Reviews paired states (muted/unmuted), palette rules (white active, gray inactive, red slash, lime live), optical alignment, and responsive layout against config/icons.json. - Use Case: After adding a new muted icon or changing config/icons.json, ask the agent to QA the deck and receive a PASS/FAIL report with screenshots, severity-ranked issues, and reproduction commands. ## Quick Start Ask the agent to run the icons-qa workflow to build the icons and visually inspect the Stream Deck preview in the browser.

Frequently Asked Questions about icons-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visually QA Stream Deck icons in a browser preview?▼

Run pnpm build and pnpm check, start pnpm dev to serve the preview at http://127.0.0.1:4173, then drive the repo-local agent-browser CLI to snapshot and screenshot the deck at desktop and narrow viewports. Compare results against config/icons.json.

How to test responsive layout of a Stream Deck icon preview?▼

Set the browser viewport to 1200x900 for desktop and 390x844 for narrow, reload, and capture full-page screenshots at each size. Verify the 5 x 3 grid keeps square keys, even gaps, and readable labels without overflow.

Can browser preview QA replace testing on a physical Stream Deck?▼

No. Browser screenshots validate structure, palette, alignment, and rendering, but cannot prove color accuracy or legibility on physical Stream Deck hardware. The findings report explicitly notes this limitation.

Why does the Stream Deck preview show broken or missing icon images?▼

Broken images usually mean stale or failed builds. Run pnpm build and pnpm check first, then verify each image loads with nonzero natural dimensions using the agent-browser eval command before continuing visual inspection.

What conventions do muted and active Stream Deck icon states follow?▼

Active audio glyphs are filled white, inactive glyphs use #666666 gray, and muted variants keep the same base glyph with a shared red diagonal slash. Broadcast live uses a vivid lime glyph while broadcast off stays dim.