Skip to content

TheGoat395/Codex-Skills / skills/ui-screenshot-composition

ui-screenshot-composition

Verified

Arrange readable product screenshot evidence.

FileKindSize
SKILL.mdskill md1.1 KB
agents/openai.yamlconfig251 B
references/ui-screenshot-composition-guide.mdmarkdown3.0 KB

references/ui-screenshot-composition-guide.md

View on GitHub
# UI Screenshot Composition Guide

## Purpose

- Turn UI screenshots into a designed evidence system, not a pile of framed rectangles.

## Use When

- A page has multiple screenshots that need hierarchy and rhythm.
- Feature sections feel like generic card grids with tiny UI images.
- Screenshots need responsive crop, annotation, zoom, or comparison treatment.

## Do Not Use When

- There are no UI screenshots or product visuals.
- A single raw screenshot is already the clearest proof.
- The task is only capturing new screenshots, not composing them.

## Discovery Questions

- Which screenshot is primary proof and which are supporting details?
- What should be visible at first glance versus on hover/zoom?
- Do annotations help, or do they clutter?
- How should screenshots crop or stack on mobile?

## Decision Tree

- Rank screenshots by evidence value.
- Use scale contrast: one dominant proof, smaller detail crops, concise callouts.
- Keep annotations outside important UI when possible.
- Use consistent frames, radii, shadows, and backgrounds.
- Test mobile stack for readability and overflow.

## Implementation Rules

- Do not create endless screenshot cards with equal weight.
- Avoid annotations that cover the UI they explain.
- Do not use heavy 3D transforms on text-heavy screenshots.
- Keep screenshots aligned to section copy and CTA intent.
- Use real screenshots or honest prototypes, not random generated UI.

## Useful Patterns

- One large workflow screenshot plus two magnified detail crops.
- Before/after comparison with consistent viewport and labels.
- Stacked dashboard cards with one highlighted metric and supporting table crop.
- Mobile-first product proof with phone screenshot and surrounding benefit copy.

## Anti-Patterns

- Every feature gets the same small rounded card.
- Screenshot wall has no focal point.
- UI is angled until unreadable.
- Callout lines, dots, and labels overwhelm the product.

## QA Checklist

- Inspect screenshot readability and focal hierarchy.
- Check mobile crop, overflow, and touch targets for zoom/detail views.
- Verify alt text/captions for informative screenshots.
- Run browser checks for asset loading and layout shift.

## Acceptance Criteria

- Screenshot composition creates clear product proof.
- Visual rhythm feels intentional and premium.
- Users can read the important UI at target viewports.

## Scoped execution

Apply the [shared web contract](../../website-operating-rules/references/scoped-web-contract.md) once when execution crosses phases; reuse it if already read. Load only the specialist guidance relevant to the requested surface and deliverable.

## Official Source Anchors

- MDN img element: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img
- MDN responsive images: https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images
- Next.js image optimization: https://nextjs.org/docs/app/getting-started/images
- W3C WAI alt decision tree: https://www.w3.org/WAI/tutorials/images/decision-tree/
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: 322kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall