TheGoat395/Codex-Skills / skills/ui-screenshot-composition
ui-screenshot-composition
VerifiedArrange readable product screenshot evidence.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.1 KB |
| agents/openai.yaml | config | 251 B |
| references/ui-screenshot-composition-guide.md | markdown | 3.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/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |