TheGoat395/Codex-Skills / skills/visual-assets-direction
visual-assets-direction
VerifiedDefine purposeful visual asset strategy.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 989 B |
| agents/openai.yaml | config | 238 B |
| references/visual-assets-direction-guide.md | markdown | 2.8 KB |
references/visual-assets-direction-guide.md
View on GitHub# Visual Assets Direction Guide
## Purpose
Ensure the site has credible visual material and that assets are framed, optimized, and purposeful.
## Use When
- The site is visual-first: luxury, hospitality, fashion, restaurant, real estate, portfolio, creator, service, product, or commerce.
- A hero or gallery needs imagery/video/generative assets.
- The site currently relies on gradients, blobs, placeholders, or weak stock-like media.
## Do Not Use When
- The site is intentionally text-only and the concept supports it.
- The user forbids image generation/search and no assets are available.
## Discovery Questions
- What is the subject viewers need to inspect: product, person, place, UI, material, outcome?
- What assets exist and what must be generated, searched, mocked, or deferred?
- What aspect ratios are needed for hero, gallery, cards, mobile crops, social previews?
- What alt text and loading behavior are appropriate?
## Decision Tree
- If subject is physical/human/place, use photography or generated bitmap imagery.
- If subject is software, use real UI for factual proof, or explicitly labeled prototype UI for illustration screenshots, workflows, code, or interface scenes.
- If subject is abstract service, use practitioner/workspace/process imagery or typographic proof.
- If assets are missing, define temporary asset slots and ask/produce what is needed.
## Implementation Rules
- Every visual asset needs purpose: establish subject, prove capability, set atmosphere, show detail, or guide action.
- Avoid dark blurry backgrounds when inspection matters.
- Define crop/focal point for desktop and mobile.
- Use stable aspect ratios to prevent layout shift.
- Optimize large assets and avoid unnecessary autoplay video.
## Useful Patterns
- Luxury hero: one strong scene plus concise captioning.
- Product hero: screenshot or render with meaningful UI state.
- Portfolio: curated artifact plates and varied crop rhythm.
- Restaurant/hospitality: atmosphere plus concrete menu/location/booking proof.
## Anti-Patterns
- Gradient blobs in place of the actual subject.
- Generic laptop mockups for every software product.
- Stock photos with no relation to the business.
- Images that crop away faces, products, rooms, or UI details on mobile.
## QA Checklist
- Check image/video loading and console/network errors.
- Inspect mobile crops for subject preservation.
- Verify alt text or decorative treatment.
- Confirm media does not obscure text or controls.
## Acceptance Criteria
- The page feels materially real rather than placeholder-driven.
- Visual assets clarify the site rather than merely decorate it.
## 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |