Skip to content

aspiers/ai-config / .agents/skills/presenting-ui-previews

presenting-ui-previews

Verified

Builds a clickable before/after screenshot gallery of web UI work, at desktop and phone widths in light and dark, where clicking any screenshot opens the actual page it came from, with a full-length screenshot one link away. Use when showing the user screenshots or previews of UI changes for review, comparing pages before and after a change, or when screenshots handed over were cropped to the first screen. For a single image or page, open it directly as orca-cli-local or open-in-user-browser describes.

Presenting UI previews

A reviewer of UI work wants to scan many views at once, then open the actual page behind any of them. A gallery of first-screen thumbnails does the first; clicking a screenshot must open the actual page it came from, not a bigger picture, with a full-length screenshot one link away, so nothing is judged from a crop.

Build the gallery

scripts/ui-gallery.py captures each page at each width and colour scheme from an "after" server and, optionally, a "before" one, and writes index.html plus one page per shot. Run it with --help for its options. It needs Playwright with Chromium: use the project's own Playwright environment where there is one, so no second browser is downloaded.

Write the output into the project's scratch directory, not the system /tmp, unless the project says otherwise.

By default it covers 1280 and 390 px, light and dark. Keep all four unless the change cannot affect one of them: a layout change can break the phone width, and a colour change the dark scheme. A "Show" selector at the top of the index narrows it to one layout, such as phone width in dark, or to one width or scheme.

The "before" state

Serve the code from before the change on a second port, from a scratch copy of the base ref (git archive <ref> | tar -x -C <dir>, then the project's setup) or a worktree of it. Never stop or reuse a server or port another agent or the user is using: pick a free port.

If the base ref can no longer be served, say so and present the after shots alone rather than mixing in older screenshots taken another way.

Signing in to a dev server

Pass --login with the path that starts a dev session. The script visits it in the browser page, not through Playwright's request client: the request client did not send a Secure session cookie back over plain http://127.0.0.1 (seen with Playwright 1.58), so a bootstrap request loops between the sign-in page and the app. Each phase, width and scheme gets its own browser context, so before and after sessions never collide.

The actual page

Every screenshot, thumbnail or full-length, opens the actual page. By default that is an MHTML snapshot the script saves for each phase and page: the rendered page with its styles, which opens in any Chromium-based browser, Orca's included, after the servers stop. Scripts do not run in it, so only native controls such as <details> still work. Where the project can export a page as one standalone HTML file that keeps working, pass it with --link; it replaces the snapshot. Each page also links the live URL, which works only while its server runs.

Show it

Open index.html for the user in the same turn: in an Orca browser tab inside Orca (orca-cli-local), otherwise with open-in-user-browser. Say which branch or commit each phase shows and that the data is demo data where it is.

Third-party tools

0xBrewing/ui-evidence was audited and trialled on 2026-11-07 and not adopted: it has no link to the real page, its thumbnails are whole pages squashed to card size, and it needs Node, its own Chromium and a YAML config. Check for anything newer before replacing this script.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 321kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall