gui-scrutiny

Verify GUI work empirically in Storybook with Playwright, axe, and anti-slop probes.

1|Updated Aug 15, 2026
One-click install
npx skills add https://github.com/AlrikOlson/think-and-ship --skill gui-scrutiny-alrikolson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gui-scrutiny
Source: https://github.com/AlrikOlson/think-and-ship/tree/main/crates/think-and-ship/skills/gui-scrutiny
Command: npx skills add https://github.com/AlrikOlson/think-and-ship --skill gui-scrutiny-alrikolson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Front-end work is often declared done after it merely renders, leaving generic AI-generated layouts, accessibility theater, fake data, and untested behavior to ship unnoticed. This Skill enforces an empirical verification bar: every component or view must be checked in a real browser, in light and dark themes, against both automated gates and a designer-grade critique before it counts as done. ## Core Features & Use Cases - Automated regression gate: Runs Storybook stories as Vitest browser-mode tests with axe accessibility checks on every story, extended with mechanical anti-slop checks (token purity, no emoji in UI strings, no lorem/placeholder copy). - Exploratory scrutiny with Playwright MCP: Drives a running Storybook in light and dark themes, takes full-frame and component-cropped screenshots, and backs every behavioral claim with DOM assertions returning JSON verdicts. - Anti-slop and object-model fidelity audits: Hunts templated layouts, unmotivated gradients, emoji-as-UI, fake metrics, and marketing microcopy, plus OOUX checks that each domain object renders through one canonical component with consistent CTAs. - Use Case: After building a new settings view, ask the agent to scrutinize it in Storybook; it boots the dev server, screenshots both themes, runs the probe library from reference/probes.md, fixes the bounded set of findings, and reports a slop ledger with evidence. ## Quick Start Ask the agent to scrutinize the current UI in Storybook with Playwright and report any AI slop, accessibility, or behavioral findings before calling the front-end work done.

Frequently Asked Questions about gui-scrutiny

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

FAQPage Schema
How do I verify a UI component in Storybook with Playwright?▼

Boot Storybook on its port, poll the iframe endpoint until it responds, then load each story at theme:dark and theme:light via the iframe URL. Take full-frame and component-cropped screenshots, and back behavioral claims with browser_evaluate DOM assertions returning JSON verdicts.

How to run accessibility tests on every Storybook story automatically?▼

Wire the Storybook Vitest addon with addon-a11y so stories run as browser-mode tests and axe checks every story in the same pass. Prove the gate is real by seeding a violation, watching it fail, then confirming it passes clean.

What is AI slop in UI design and how do I detect it?▼

AI slop is generic, templated, dishonest UI: unmotivated gradients, emoji-as-icons, lorem or fake metrics, off-scale spacing, and marketing microcopy in utility tools. Detect it with mechanical probes (emoji scans, gradient censuses, placeholder-copy regex) plus a designer-grade read against the project's own design grammar.

Does this verification approach work without Storybook?▼

No. The entire workflow is built around Storybook stories as the test and review surface, including the Vitest addon gate and iframe-based Playwright driving. If the project has no Storybook, the skill explicitly does not apply.

Why do full-page screenshots miss UI detail problems?▼

At 1:1 frame scale, 10-14px text is only a few pixels tall, so typography, icon weight, casing, and emoji-as-icon tells are sub-legible and get rubber-stamped. Component-scoped cropped screenshots via a target selector are mandatory for any element carrying small type or fine detail.

What is object-model fidelity checking in UI review?▼

It is an OOUX-based audit verifying each domain object renders through one canonical component, stays recognizable across zoom levels, and offers consistent CTA labels everywhere it appears. A second drifting renderer for the same object is flagged as dead code and blocks completion.