Skip to content

TheGoat395/Codex-Skills / skills/hero-image-art-direction

hero-image-art-direction

Verified

Compose text-safe responsive hero media.

FileKindSize
SKILL.mdskill md1.1 KB
agents/openai.yamlconfig248 B
references/hero-image-art-direction-guide.mdmarkdown3.2 KB

references/hero-image-art-direction-guide.md

View on GitHub
# Hero Image Art Direction Guide

## Purpose

- Make the first viewport immediately specific, inspectable, and composed.

## Use When

- A page needs a hero image, video poster, visual background, or first-screen media choice.
- Current hero media is generic, too dark, too cropped, or fighting the typography.
- A mobile hero needs a different crop or asset from desktop.

## Do Not Use When

- The page is a dense app/tool where a hero is inappropriate.
- The user explicitly wants a text-only or data-first first viewport.
- The image is purely decorative and should be removed.

## Discovery Questions

- What should users understand in the first three seconds?
- Is the hero subject the product, place, person, work, interface, or atmosphere?
- Where can headline and controls sit without covering essential details?
- Do desktop and mobile need separate crops, art direction, or media files?

## Decision Tree

- Pick the subject and focal area before layout.
- Choose media with real inspectable content and enough quiet space for type.
- Define aspect ratio, object-position, and crop behavior per breakpoint.
- Tune overlay treatment only after image and type are placed.
- Verify first viewport and next-section hint on mobile and desktop.

## Implementation Rules

- Do not let overlay gradients hide weak or irrelevant imagery.
- Avoid split hero cards when an immersive media-first hero is expected.
- Do not crop faces, products, rooms, or UI details that carry meaning.
- Use a different mobile crop when the desktop composition fails.
- Keep text real HTML, not baked into the image.

## Useful Patterns

- Full-bleed venue image with low, quiet type zone and visible next section.
- Product close-up with strong silhouette and secondary proof nearby.
- Portfolio hero with one memorable work artifact, not a grid of thumbnails.
- Editorial portrait with environmental context and restrained overlay.

## Anti-Patterns

- Centered headline on a random unspecific background.
- Hero image cropped so the actual product is off-screen on mobile.
- Dark overlay used until the image no longer matters.
- Stock business photo with no connection to the offer.

## QA Checklist

- Inspect at desktop, laptop, tablet, and mobile widths.
- Check text contrast and focal point at each crop.
- Verify image loading, dimensions, and no layout shift.
- Confirm the first viewport shows the brand/product/place/person clearly.

## Acceptance Criteria

- The hero media carries the page concept immediately.
- Text, controls, and focal point coexist across viewports.
- The result feels composed rather than templated.

## 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 picture element: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/picture
- 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
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall