agh-ui-screenshot

Official

Create deterministic UI PNGs with CDP.

Authorcompozy
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It solves the problem of flaky and inconsistent UI screenshots caused by Storybook iframes and font-loading race conditions, which makes visual regression comparisons unreliable.

Core Features & Use Cases

  • Deterministic PNG capture via CDP: Drives headless Chrome through the Chrome DevTools Protocol to capture stable screenshots without relying on Chrome’s built-in screenshot behavior.
  • Font-stable rendering: Waits for document.fonts.ready (and a React/Storybook settle window) to avoid mid-FOUT captures and fallback-font artifacts.
  • Flexible target support: Captures Storybook isolation iframes using story-id URL grammar and also captures arbitrary local URLs (including the proposal mock HTML).
  • Batch-friendly workflow: Reuses a single Chrome instance for multiple captures per run and emits per-shot failures as FAIL lines while continuing the batch.

Quick Start

Run: bash .agents/skills/agh-ui-screenshot/scripts/setup-workdir.sh /tmp/agh-ui-screenshot to prepare an isolated workdir for deterministic screenshot capture.

Dependency Matrix

Required Modules

bunchrome-launcherchrome-remote-interfacepython3curl

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: agh-ui-screenshot
Download link: https://github.com/compozy/agh/archive/main.zip#agh-ui-screenshot

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.