mcpbeat

Ecommerce Product Imagery

calesthio/ecommerce-product-imagery

Provider-independent ecommerce product imagery production for marketplace listings, product pages, hero shots, lifestyle scenes, comparison charts, infographics, variant/packaging images, virtual try-on or placement mockups, ads, and AI-assisted product visuals. Use when an agent must plan, generate, edit, review, localize, package, or QA truthful commercial product images while managing SKU continuity, marketplace requirements, claims, rights, releases, accessibility, and approval.

11k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
112
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/calesthio/generative-media-skills --skill ecommerce-product-imagery

What comes with it

14 660 bytes besides the instruction
EVAL.md

The instruction itself

24 sections, as written by the author

Ecommerce Product Imagery

Use this skill to produce commercially usable product imagery, not just attractive pictures. The governing rule is: the image must help a buyer understand the actual purchasable product without inventing features, quantities, sizes, colors, materials, packaging, certifications, results, endorsements, or included accessories.

Operating principles

Separate three categories before creating anything:

  • Documented product fact: confirmed by physical sample, client PDP, packaging, SKU sheet, spec sheet, or approved brand guide.
  • Creative direction: lighting, setting, camera, styling, props, layout, crop, visual hierarchy, and mood.
  • Regulated or platform-sensitive claim: performance claims, health/beauty outcomes, environmental claims, comparative superiority, pricing, discounts, guarantees, safety, awards, certifications, shipping promises, and "before/after" implications.

Do not let category 2 change category 1. Do not render category 3 unless the client supplies substantiation and approves the exact wording and visual implication.

Label your own assertions while working:

  • Documented fact: cite the source artifact or page.
  • Production heuristic: explain that it is a practical rule of thumb.
  • Volatile platform fact: include the date checked and tell the user it must be re-checked before upload or ad launch.
  • Legal/compliance risk: do not give legal advice; escalate to client, counsel, or marketplace review.

First response workflow

For any ecommerce image request, collect or infer the minimum viable brief:

  • Product identity: brand, product name, SKU/ASIN/GTIN, variant names, bundle quantity, packaging version, included accessories.
  • Channel: Amazon, Shopify/PDP, Google Merchant Center/Shopping, Meta ads, TikTok ads, retail media, email, marketplace carousel, A+ content, social organic, print, or internal concepting.
  • Deliverables: count, orientation, aspect ratio, transparent/white background, lifestyle, infographic, comparison, size chart, localized versions, ad versions, thumbnails.
  • Source material: packshots, packaging flats, label art, CAD/3D files, brand guide, prior approved imagery, physical sample photos, model/property releases.
  • Truth constraints: dimensions, colors, material finish, ingredients, claims, certifications, warranty, target market, restricted categories.
  • Use of generation/editing: full generation, background replacement, compositing, cleanup, upscaling, virtual placement, virtual try-on, synthetic models, or concept-only.
  • Approval path: who approves product accuracy, claims, legal/compliance, marketplace upload, and final art.

If the user asks for production before this information exists, proceed only with a clearly marked concept or placeholder plan. Do not create final commercial imagery when product truth cannot be verified.

Product truth and SKU continuity

Treat the SKU as the continuity anchor. Every image in a set must depict the same sellable item unless the deliverable intentionally compares variants.

Maintain a small product truth table:

| Field | Required source | QA check |

|---|---|---|

| SKU/variant | SKU sheet, PDP, package, order system | Same variant name and color across all images |

| Color/material | sample photo under neutral light, brand spec, material swatch | No hue shift, texture swap, or invented finish |

| Scale/dimensions | dimensions sheet, model/hand reference, known object | Product does not appear misleadingly large or small |

| Packaging | approved label art, packaging flat, sample photo | Correct front/back/side, barcode/claims if visible |

| Included items | SKU contents or bundle list | No extra accessories, props, refills, chargers, stands, or ingredients implied as included |

| Claims | approved claims deck, substantiation, legal approval | Exact wording and visual implication approved |

| Compliance marks | certification documentation | Marks are real, current, and used according to owner rules |

Never invent:

  • logos, label text, nutrition/drug/supplement facts, certifications, seals, badges, QR codes, barcodes, serial numbers, warning labels, or regulatory markings;
  • product performance outcomes such as "whitens teeth," "cures acne," "non-toxic," "100% biodegradable," "clinically proven," or "FDA approved" without explicit substantiation;
  • variant colors or bundle quantities;
  • endorsements, awards, press mentions, reviews, ratings, or marketplace badges.

If an image model cannot reproduce text/logo/label details reliably, use compositing: generate or photograph the scene with a blank/neutral product surface, then overlay approved vector/raster label art in a conventional editor or design tool. QA the final pixels at 100% and at marketplace thumbnail size.

Reference and capture strategy

Prefer real references over prompt descriptions. Request:

  • neutral front, back, side, top, bottom packshots;
  • one angled hero reference;
  • close-ups of distinctive materials, seams, ports, ingredients, texture, stitching, finish, cap, applicator, or hardware;
  • label or packaging art as flat files, not only perspective photos;
  • a ruler, hand, model, or known object when scale matters;
  • color target or neutral-light reference when color accuracy matters;
  • separate references for every variant and packaging version.

For AI-assisted workflows, use references narrowly:

  • Identity reference: preserves shape, silhouette, label placement, distinctive features.
  • Material reference: preserves finish, texture, transparency, fabric, metal, glass, plastic, liquid, powder, or food surface.
  • Scene reference: guides environment and lighting only.
  • Layout reference: guides infographic/chart composition.

Do not use a competitor's image as a style or composition reference in a way that copies distinctive trade dress, layout, proprietary packaging, or campaign art. Use broad category language instead.

Shot types and production guidance

Marketplace primary image

Goal: a clear sellable product identifier.

  • Use a neutral or pure white background when required by the destination.
  • Show only what is included with the purchase.
  • Avoid props, lifestyle context, decorative overlays, badges, ratings, or unsupported text unless the specific marketplace and category permit them.
  • Keep product geometry natural; avoid wide-angle distortion.
  • Leave margins for marketplace cropping while keeping the product large enough to recognize.
  • For mirrored/glossy materials, preserve real reflections without changing product color or shape.

Volatile platform note verified 2026-07-11: Amazon product image requirements are category- and locale-sensitive; Seller Central image rules include main-image restrictions and minimum technical requirements. Re-check the active Seller Central help page for the target marketplace before upload: https://sellercentral.amazon.com/help/hub/reference/external/G1881

Use secondary images to answer buyer questions:

  • scale in hand, on body, in room, on desk, inside bag, or next to measured objects;
  • material/texture macro;
  • open/closed states;
  • included components laid out;
  • packaging front/back;
  • benefit diagram with substantiated claims;
  • how-to-use sequence;
  • variant comparison;
  • compatibility chart;
  • before/after only when substantiated, truthful, and allowed by the platform/category.

Lifestyle images

Lifestyle scenes may be aspirational, but product facts remain literal.

  • Match plausible use context, climate, demographics, and geography.
  • Keep the product readable, not hidden by props.
  • Do not imply unapproved use cases, medical outcomes, safety performance, environmental benefits, or social status guarantees.
  • Ensure props are not mistaken as included items. Add captioning or layout clarity when needed.
  • For food, cosmetics, supplements, children's products, medical devices, and safety products, escalate riskier scenes for compliance review.

Hero shots and ads

Hero imagery may exaggerate drama, not facts.

  • Use lighting, composition, motion cues, scale of set, and background to create premium feel.
  • Do not enlarge the product relative to the buyer's likely expectation unless the image is clearly symbolic.
  • If using splashes, particles, ingredients, smoke, flames, ice, flowers, or scientific graphics, ensure they communicate approved attributes only.
  • For paid ads, re-check platform creative and claims policies at launch time; ad review standards change.

Volatile platform notes verified 2026-07-11:

  • Google Merchant Center image and product data requirements are enforced through attributes such as image_link; check current rules before feed submission: https://support.google.com/merchants/answer/6324350
  • Google Merchant Center currently requires generative-AI product images to retain embedded AI-source metadata such as IPTC DigitalSourceType; do not strip provenance metadata when exporting or optimizing feed images. Re-check before submission: https://support.google.com/merchants/answer/6324350
  • Meta's Advertising Standards cover misleading claims, personal attributes, before/after and other sensitive content; check current standards before ad launch: https://transparency.meta.com/policies/ad-standards/
  • TikTok advertising policies cover misleading, exaggerated, and prohibited claims and landing-page consistency; check current rules for region/category: https://ads.tiktok.com/help/article/tiktok-advertising-policies-ad-creatives-landing-page

Infographics, comparison charts, and callout images

Use infographics to clarify, not to decorate.

  • Anchor every claim to an approved source.
  • Use exact units, dimensions, materials, compatibility, counts, and version names.
  • Avoid "best," "#1," "clinically proven," "non-toxic," "eco-friendly," "safe," "guaranteed," and similar claims unless substantiated and approved.
  • If comparing with competitors, require client/legal approval for the comparison basis, date, methodology, and jurisdictions.
  • Make chart axes, icons, and callouts legible at mobile thumbnail scale.
  • Preserve accessibility: do not rely on color alone; use text labels and contrast.

Variant, bundle, and packaging images

  • Create a variant matrix before rendering: variant name, color, finish, size, scent/flavor, packaging art, quantity, and any unique claims.
  • Keep camera angle, lighting, crop, and scale consistent across variants unless intentionally showing a functional difference.
  • Do not "average" variants in prompts. Render or composite each variant from its own reference.
  • For bundles, show exactly the quantity and components included. If the image includes non-included props, visually separate them.
  • For localized packaging, do not translate legal labels, warnings, ingredients, or regulated information without client-provided localized art.

Virtual try-on, synthetic models, and placement mockups

Use these as fit/context aids, not proof of universal fit.

  • Require model consent/releases for real identifiable people.
  • For synthetic people, avoid implying endorsement by a real person or protected-class targeting.
  • For apparel/accessories, preserve actual pattern scale, seam placement, hardware, opacity, and drape as far as the source material allows.
  • For furniture/home placement, verify dimensions and show room scale honestly.
  • Mark approximate visualization when exact fit, color, or scale cannot be guaranteed.
  • Escalate high-risk uses: children, medical/health products, body-image transformations, beauty outcomes, biometric/face edits, regulated uniforms, culturally sensitive garments, or private property.

AI-generated and AI-edited image boundaries

Before using generation, classify the task:

  • Safe for generation: background, lighting mood, generic props, abstract ingredient atmosphere, empty rooms, concept boards, non-final exploratory ads.
  • Use generation plus compositing: product in lifestyle scene, hero image with accurate label, packaging variants, infographic backgrounds, ad layouts.
  • Use real photography/3D or client assets first: main marketplace image, exact color/material, regulated packaging, dense label text, legally significant marks, technical dimensions.
  • Do not generate without escalation: claims requiring evidence, identifiable real people without release, celebrity/public figure likeness, private property/trade dress, medical/legal/financial promises, competitor comparisons, platform badges/reviews.

Generation prompts should preserve product truth by separating fixed facts from creative variables:

Fixed product facts:
- [SKU name, color, finish, exact included components, dimensions, packaging version]
- Preserve silhouette, label placement, material, and scale from references.

Creative direction:
- [camera angle, lens feel, lighting, surface, background, styling]

Negative constraints:
- No extra accessories, no changed logo, no invented text, no badges, no claims, no altered color, no deformation, no additional variants.

Post-production plan:
- Composite approved label/logo from source file; QA against reference; export platform crops.

Record model/tool, version if available, date, prompt, references, seed/settings if available, edits, and human approvals. This audit trail is useful for reproducibility, rights review, and correcting defects.

Claims, compliance, and escalation

Use this decision rule: if an image would cause a reasonable buyer to believe something about performance, safety, health, ingredients, sustainability, certification, pricing, scarcity, compatibility, or endorsement, treat it as a claim.

Escalate to client/counsel/compliance before final use when imagery includes:

  • health, medical, wellness, supplement, beauty, weight-loss, body-transformation, child-safety, financial, insurance, legal, or environmental claims;
  • before/after images or outcome simulations;
  • comparative claims against competitors;
  • certification marks, government agency references, seals, awards, reviews, marketplace badges, "Amazon's Choice," star ratings, press logos, or influencer endorsements;
  • "free," discount, price, guarantee, warranty, delivery, return, inventory, or limited-time claims;
  • user-generated content, testimonials, influencer/affiliate content, or material connections that may require disclosure;
  • altered model bodies, skin, results, or fit;
  • restricted categories or regional legal differences.

Official FTC references verified 2026-07-11:

  • Advertising claims require a reasonable basis and substantiation before dissemination: https://www.ftc.gov/business-guidance/advertising-marketing/advertising-claims
  • Endorsements and testimonials must be truthful and disclose material connections where required: https://www.ftc.gov/business-guidance/advertising-marketing/endorsements-influencers-reviews
  • Environmental marketing claims require care and substantiation; check current Green Guides/status before using green claims: https://www.ftc.gov/business-guidance/advertising-marketing/environmental-marketing

Do not provide legal advice. Say what needs approval and why.

Rights, releases, and provenance

For final commercial imagery, track provenance:

  • who supplied each asset;
  • license/ownership status;
  • model/property release status;
  • AI tool and settings;
  • post-production edits;
  • approval timestamp and approver.

Require explicit approval or counsel review before using:

  • recognizable people, tattoos, uniforms, private homes, distinctive architecture, vehicles, license plates, pets with owners, artworks, branded props, third-party logos, screenshots, app UIs, maps, copyrighted packaging, celebrity lookalikes, or public-figure likenesses;
  • AI-generated people that resemble real individuals;
  • stock assets outside license terms;
  • marketplace badges, platform logos, or partner marks.

Helpful rights/provenance references verified 2026-07-11:

  • U.S. Copyright Office guidance on works containing AI-generated material and human authorship: https://www.copyright.gov/ai/
  • Getty Images release guidance for recognizable people and property in commercial content: https://contributors.gettyimages.com/article_public.aspx?article_id=5310
  • Adobe Stock model/property release guidance for recognizable people and property: https://helpx.adobe.com/stock/contributor/content-policies-guidelines/model-property-releases.html
  • C2PA Content Credentials are a provenance mechanism, not a truth guarantee; use them when a workflow or client requires disclosure metadata: https://c2pa.org/specifications/specifications/2.1/index.html

Accessibility and localization

For each final asset or PDP module, provide alt text or image description guidance:

  • Describe product identity, variant, visible function, and essential text.
  • Do not start with "image of" unless useful for context.
  • Keep decorative background details out unless they affect meaning.
  • Include visible claims or instructions if the image conveys them and they are not duplicated nearby.
  • For charts/infographics, summarize the comparison or key data, not just the visual style.

Use W3C/WAI guidance for meaningful, concise alternatives and re-check client/platform CMS limits. Reference verified 2026-07-11: https://www.w3.org/WAI/tutorials/images/

Localization workflow:

  • Localize claims, units, warnings, ingredients, and legal text from approved copy only.
  • Re-check marketplace/ad rules by country, language, category, and product type.
  • Confirm cultural fit of models, gestures, colors, holidays, home settings, food use, clothing, and symbols.
  • Produce separate files for each locale with locale code in the filename and metadata.
  • QA right-to-left scripts, text expansion, decimal/unit formats, and non-Latin legibility.

Review and approval workflow

Use a staged review instead of a single final approval:

  • Truth lock: approve product truth table, variants, claims, and references.
  • Concept approval: approve shot list, channel specs, and generation/editing boundaries.
  • Rough proof: review composition, scale, crop, visual hierarchy, and claim placement before costly refinements.
  • Product accuracy QA: compare against references for shape, color, material, label, included items, and scale.
  • Compliance/platform QA: re-check marketplace/ad rules, claims, releases, and disclosures.
  • Accessibility/localization QA: alt text, readable text, contrast, language variants.
  • Final delivery approval: export package, source/audit notes, and approver sign-off.

Do not treat "looks good" as product/legal approval. Ask for the approver by role when risk exists: brand owner, product manager, regulatory/compliance, legal, marketplace specialist, or paid-social owner.

Delivery package

A complete handoff commonly includes:

  • final exports named by product, SKU/variant, channel, shot type, aspect ratio, locale, and version;
  • layered source files or editable design files when requested;
  • approved reference/source assets used;
  • prompt/model/settings log for generated or AI-edited elements;
  • retained AI-source/provenance metadata when required by the destination platform or client workflow;
  • claim substantiation references or approval notes, if claims appear;
  • release/license notes for models, property, stock, props, and fonts;
  • alt text or CMS-ready descriptions;
  • platform upload notes, including volatile rules re-checked date;
  • QA checklist with pass/fail notes and residual risks.

Example filename pattern:

brand-product-sku1234_black-main-amazon-us_2000x2000_v03.png
brand-product-sku1234_black-lifestyle-pdp-us_4x5_v03.png
brand-product-sku1234_all-variant-comparison-shopify-en-us_v02.png

Ecommerce imagery QA checklist

Before final delivery, inspect at 100%, at mobile thumbnail size, and in the intended crop.

Product accuracy:

  • Correct SKU, variant, quantity, and packaging version.
  • Shape, color, material, finish, transparency, texture, label position, and scale match references.
  • No extra included items, missing items, impossible assembly, or misleading context.
  • Text/logo/label is exact or deliberately removed/blurred; no invented readable text.

Channel/platform:

  • Current marketplace/ad specs re-checked for target platform, locale, category, and placement.
  • Dimensions, aspect ratio, file type, safe areas, background requirements, and text restrictions fit the destination.
  • Primary image rules are separated from secondary/lifestyle/ad creative rules.

Claims/compliance:

  • Every explicit and implied claim is approved and substantiated.
  • No unsupported environmental, health, safety, superiority, scarcity, pricing, or endorsement claims.
  • Required disclosures are present and legible where applicable.
  • Restricted categories reviewed.

Rights/provenance:

  • Model/property releases and licenses are documented.
  • No unlicensed third-party logos, art, screenshots, private property, or celebrity/public figure likeness.
  • AI provenance and edits are logged when relevant.

Accessibility/localization:

  • Alt text/image descriptions prepared.
  • Text is readable on mobile and meets contrast needs.
  • Localized versions use approved translated copy and correct units.

Final package:

  • Filenames and versions are clear.
  • Source files and audit notes included if requested.
  • Residual risks are stated plainly.

Example: white-background marketplace set

Example production intent: create a compliant marketplace packshot and secondary images for a stainless-steel insulated bottle.

Inputs:

  • SKU sheet: 24 oz, brushed stainless, screw cap, no straw included.
  • Product reference photos: front, back, cap detail, bottom mark.
  • Destination: Amazon US listing plus Shopify PDP.
  • Claims: "keeps drinks cold up to 24 hours" supplied by client but not yet substantiated.

Workflow:

  • Create a truth table: 24 oz, brushed stainless, screw cap, no straw, no handle, bottle only.
  • For the Amazon primary image, use real cutout photography or product-preserving edit on pure white; no props, no callouts, no "24h cold" text until approved.
  • For secondary images, produce:
  • scale-in-hand lifestyle;
  • cap close-up;
  • dimension callout using approved dimensions;
  • packaging/contents layout showing bottle and cap only.
  • If using AI background replacement, lock the bottle mask and composite it into scenes instead of regenerating the bottle.
  • Escalate the "24h cold" claim for substantiation and platform review before placing it in any image.

Example prompt for the lifestyle background generation stage:

Create a bright modern kitchen counter background for a reusable insulated bottle product photo.
Camera at countertop height, 70mm product-photography feel, soft window light from left, neutral stone counter, subtle blurred kitchen behind.
Leave a clean central vertical space for compositing the supplied bottle cutout.
Do not generate any bottle, logo, text, human hand, straw, handle, badge, rating, discount, or claim.

Expected result: the real bottle cutout remains the product source of truth; the generated background supplies context only.

Likely failure modes: generated bottle appears in background, the composited bottle looks too large, reflections conflict with scene lighting, or the unapproved cold-duration claim appears in a callout.

Example: beauty product lifestyle ad with claims risk

Example production intent: generate paid-social hero images for a vitamin C serum.

Inputs:

  • Approved product packshot and label art.
  • Destination: Meta and TikTok ads.
  • Client-suggested copy: "Erase dark spots in 7 days."
  • Model: synthetic hand only, no face.

Approach:

  • Treat "erase dark spots in 7 days" as a high-risk performance/beauty claim. Do not include it without substantiation and legal approval.
  • Use safer creative direction: product bottle on reflective bathroom shelf, citrus-colored light, clean skincare mood.
  • Composite approved label art; do not rely on generation for label text.
  • Avoid before/after skin imagery unless approved and platform-permitted.
  • Prepare two copy-safe versions: no claim; approved ingredient-only claim if supplied.

Example image direction:

Hero lifestyle scene for a premium vitamin C serum bottle.
Warm morning bathroom light, translucent amber glow, clean reflective shelf, soft citrus-toned background bokeh.
Central product area reserved for compositing the approved bottle and label art.
Elegant, clinical-but-warm skincare mood.
No face, no skin transformation, no before/after comparison, no medical claim, no discount badge, no invented label text.

Why structured this way: the visual supports a premium skincare mood while avoiding unsubstantiated outcome claims and unreliable AI label rendering.

Example: variant comparison chart

Example production intent: create a PDP image comparing three backpack sizes.

Inputs:

  • Three variants: 18L, 24L, 32L.
  • Approved dimensions, colors, weight, laptop compatibility.
  • Channel: Shopify PDP and Google Merchant Center feed image.

Workflow:

  • Use identical camera angle and lighting for each variant.
  • Place products on a shared baseline so scale differences are honest.
  • Build a table with only approved values: capacity, dimensions, laptop size, weight.
  • Avoid "best for everyone" language; use descriptive use cases if approved.
  • Export a PDP infographic and a cleaner feed-safe image if feed rules restrict overlays.

Example chart copy:

18L Compact Day Pack  -  13 in laptop, 0.72 kg
24L Everyday Pack  -  15 in laptop, 0.88 kg
32L Travel Pack  -  16 in laptop, 1.05 kg

QA focus: baseline alignment, exact dimensions, legibility on mobile, and no swapped product images.

Source notes

Sources and volatile policy references were checked on 2026-07-11. Marketplace, ad-platform, category, locale, and regulatory requirements change; always re-check the live rules before final upload or media spend.

Primary/official sources used:

  • Amazon Seller Central product image requirements: https://sellercentral.amazon.com/help/hub/reference/external/G1881
  • Google Merchant Center image_link and image data guidance: https://support.google.com/merchants/answer/6324350
  • Meta Advertising Standards: https://transparency.meta.com/policies/ad-standards/
  • TikTok Advertising Policies for creatives and landing pages: https://ads.tiktok.com/help/article/tiktok-advertising-policies-ad-creatives-landing-page
  • FTC advertising claims guidance: https://www.ftc.gov/business-guidance/advertising-marketing/advertising-claims
  • FTC endorsements, influencers, and reviews guidance: https://www.ftc.gov/business-guidance/advertising-marketing/endorsements-influencers-reviews
  • FTC environmental marketing guidance: https://www.ftc.gov/business-guidance/advertising-marketing/environmental-marketing
  • W3C/WAI image accessibility tutorials: https://www.w3.org/WAI/tutorials/images/
  • U.S. Copyright Office AI initiative/guidance: https://www.copyright.gov/ai/
  • C2PA specifications: https://spec.c2pa.org/specifications/specifications/2.4/index.html
  • Getty Images commercial release guidance: https://contributors.gettyimages.com/article/3069
  • Adobe Stock model/property release guidance: https://helpx.adobe.com/stock/contributor/content-policies-guidelines/model-property-releases.html

How to use it

Copy the folder

Take calesthio/ecommerce-product-imagery from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.