Skip to content

TheGoat395/Codex-Skills / skills/visual-assets-direction

visual-assets-direction

Verified

Define purposeful visual asset strategy.

FileKindSize
SKILL.mdskill md989 B
agents/openai.yamlconfig238 B
references/visual-assets-direction-guide.mdmarkdown2.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.
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