product-shots-ad-creative skill

Ad Creative Design

Designs ad creatives that are platform-native (correct dimensions, safe zones, text overlay policy, character limits), industry-precise (visual DNA per industry × ad objective), and prompt-sanitized (no platform names / UI artifacts / fake ad elements leak into the image generator). The skill lays out an 8-platform × 21-format matrix, a six-step workflow, a self-check gate, and a banned-words system with a positive-preservation companion rule.

Engagement Principles

These rules apply across every Section. Read before acting.

1. No generic one-size-fits-all creatives — every creative is locked to a specific (platform, format, objective, industry) tuple. No tuple = no work.
2. Hard Constraints first — Section 0 (Platform Dimensions / Safe Zones / Text Overlay / Ad Copy Char Limits) is loaded at Step 0 and re-validated at the Self-Check Gate before delivery. Violations like "text on Google Display" or "CTA in TikTok bottom 18%" cause platform takedowns or render the ad invisible.
3. Brand Name & User Copy Fidelity is MUST-level — every brand name, slogan, CTA text, and price/offer the user specified must appear verbatim in the deliverable. Never paraphrase, translate, or substitute user-supplied copy.
4. Industry × Objective drives composition + color — pick the composition pattern and color strategy from the cross-decision matrix (Section 8 / Section 9), not from generic style intuition.
5. Platform Style Profiles are not stylistic suggestions — they are constraints. TikTok requires anti-ad aesthetic AND complete brand/product/CTA info; LinkedIn requires ≥60pt fonts; Pinterest requires aspirational scenes; Google Display requires zero text overlay.
6. Prompt Banned Words are filtered out of the image generator prompt — platform names, ad-UI terms, brand-tool names never reach the model. They are used internally for routing and rule selection only.
7. Required Positive Instruction protects native packaging text — "no text overlay" must not delete printed text on the product itself. Always pair the banned-words filter with the positive preservation instruction (references/banned-words.md §Required Positive Instruction).
8. Match the user's language — respond in English if the user writes English, in Chinese if Chinese. Never switch language unprompted.
9. Use for option sets — when proposing platform / objective / industry / asset choices, wrap them in tags. Never ask multiple questions at once.

Execution Procedure

generate_ad_creative(user_request) → variant[] + self_check
# This EP IS the inlined procedural backbone. Each Step calls the EP entry point
# of its corresponding reference module — bindings below are bidirectional (every
# call has a matching `def` in references/*.md).

# Step 0 — Pin hard constraints (MUST, before any decision)
load references/hard-constraints.md
    → Platform Dimensions / Safe Zones / Text Overlay Rules / Ad Copy Char Limits
load references/banned-words.md
    → Prompt Banned Words + Required Positive Instruction (Preserve Native Packaging Text)
keep these in working context for every step.
defer enforcement to Step 6 — `enforce_constraints(format, output_text, prompt_text, user_copy)`
will be called there with the four params built up over Steps 1–5.

# Step 1 — Platform + Objective (Quick Start: 7 required fields)
brief_state = preflight(user_request)  # references/quick-start-and-fidelity.md
collect 7_required_fields:
    platform, format, ad_objective, industry,
    visual_assets, brand_kit, copy (brand_name / slogan / cta / price)
missing = [f for f in 7_required_fields if not provided(f)]
if missing:
    filled = Skill("product-shots", f"fill missing fie

TOC of Module Files

• references/hard-constraints.md — Section 5 (Hard Constraints, 4 sub: Platform Dimensions / Safe Zones / Text Overlay Rules / Ad Copy Character Limits). MUST-level. Loaded at EP Step 0 and re-validated at Step 6.
• references/banned-words.md — Section 20 (Prompt Banned Words, 3 sub: Exception / Banned Words List / Required Positive Instruction). MUST-level. Loaded at EP Step 0 alongside hard-constraints.md and re-validated at Step 6. Split from hard-constraints.md to keep both files under the 300-line cap.
• references/quick-start-and-fidelity.md — Section 3 (Target Users), Section 4 (Quick Start — 7 Required Fields), Section 5 (Brand Name & User Copy Fidelity Rule).
• references/workflow-and-self-check.md — Section 6 (Core Workflow Six-Step Process), the procedural backbone with the Self-Check Gate.
• references/industry-style-rules.md — Section 7 (Industry Style Rules), industry × visual parameters (color, composition, typography, CTA tone, forbidden, market share).
• references/ad-objective-rules.md — Section 8 (Ad Objective Rules — Objective Determines Information Hierarchy).
• references/platform-style-profiles.md — Section 9 (Platform Style Profiles — Quick Reference, per-platform tone / production / text style / refresh cadence / what works / avoid).
• references/composition-patterns.md — Section 10 (Composition Patterns — Shared Pattern Library, 12 patterns).
• references/color-and-cta-strategy.md — Section 11 (Color Strategy: Industry × Color Matrix + Color Rules) + Section 12 (CTA Strategy).
• references/multi-platform-output.md — Section 13 (Multi-Platform Output Rules) + Section 14 (Creative Fatigue & Refresh Cadence).
• references/failures-defaults-output.md — Section 15 (Common Failure Modes) + Section 16 (Defaults — Fallback Values When User Doesn't Specify) + Section 17 (Output Format) + Section 18 (Performance Benchmarks).

Section Index

Goal — No Generic One-Size-Fits-All Creatives        → SKILL.md §Goal
Language Rule                                        → SKILL.md §Language Rule
Target Users — Small Business Owners and Marketers   → references/quick-start-and-fidelity.md §Target Users
Quick Start — 7 Required Fields Before Generating    → references/quick-start-and-fidelity.md §Quick Start
Brand Name & User Copy Fidelity Rule                 → references/quick-start-and-fidelity.md §Fidelity Rule
Hard Constraints — Must Not Be Violated              → references/hard-constraints.md
  Platform Dimensions — Quick Reference
  Safe Zones — Each Platform's UI Overlays Differ Completely
  Text Overlay Rules — Text Policies Vary Drastically Across Platforms
  Ad Copy Character Limits
Core Workflow — Six-Step Process                     → references/workflow-and-self-check.md
  Step 1: Platform + Objective
  Step 2: Industry + Brand
  Step 3: Visual Asset Audit — Available Assets Determine the Creative Ceiling
  Step 4: Composition + Color — Determined by Industry × Objective
  Step 5: Platform Adaptation Layer — Inject Platform-Specific Differences
  Step 6: Self-Check Gate — Quality Check Before Delivery
Industry Sty

Goal

Design ad creatives that are platform-native (precise dimensions, safe zones, text overlay policy, character limits), industry-precise (visual DNA matched to industry × ad objective), and prompt-clean (no fake UI / watermarks / platform names leak into the image generator). Refuse to produce a generic "one-size-fits-all" image. Every variant passes a self-check gate before delivery.

Language Rule

Always respond in the user's language.
IF user writes in English THEN respond in English
IF user writes in Chinese THEN respond in Chinese
NEVER switch language unprompted.

IMPORTANT — Suggestion Format

IMPORTANT！Suggestion:
Always use <suggestion> format to guide the user.
Do not ask several questions at once.

Example: use <suggestion> format to provide options like
Instagram (Feed / Story / Reel / Carousel) / Facebook / TikTok / LinkedIn /
Google Display / Google Demand Gen / YouTube / Pinterest / X (Twitter) / Other platform.

This is the front-end rendering instruction — option sets are wrapped in tags so the UI renders them as clickable chips.

Cross-Skill Notes

• Upstream router: product-shots routes here when assettype == "ad" or ispromotion == True. The conditional pre-fill for Quick Start fields happens inside product-shots's clarification state machine; the actual six-step workflow runs inside this skill (Section 6).
• Quick Start dependency: when any of the 7 required fields is missing, this skill defers to product-shots for clarification ("If any of these are missing, use hub first."). This is conditional pre-fill, not a hand-off — once fields are filled, control returns here.
• Brand Kit: when the user provides a Brand Kit (file path or inline colors / fonts / logo), Step 2 integrates it as hard constraints. Brand Kit overrides industry-default colors and is a cross-skill consistency anchor shared with all peer product-shots skills.
• Industry Visual DNA is shared with product-shots-social-post and product-shots (cross-skill consistency).
• Image generation backend: rendered prompts are dispatched to product-shots-image-gen (the product-shots image-gen engine) which abstracts the underlying API (OmniMaaS / OpenAI / Gemini).
• Adjacent boundary skills (peers, not invoked from inside product-shots-ad-creative): product-shots-social-post (organic social content, no ad-objective layer), product-shots-main-image (Amazon-compliant product main image), product-shots-detail-page (Amazon A+ Content), product-shots-multi-angle (model-consistency portrait series).

Tooling

• product-shots — invoked when any of the 7 required fields is missing (Quick Start gate).
• product-shots-image-gen — invoked at output assembly to actually generate images from the composed prompts.
• Brand Kit input (Step 2) — parsed directly from a user-provided file path or inline fields. No external tool call required.