agentsclimarketplace

Product shots main image

Skill motiful/product-shots/skills/product-shots-main-image

Open-source Claude Code skills that turn one product photo into a full set of e-commerce visuals — main images, A+ detail pages, multi-angle shoots, social posts, and ad creatives. For cross-border sellers on Amazon, Shopify, TikTok Shop.

Install
npx -y skills add motiful/product-shots --skill product-shots-main-image

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Designs Amazon-compliant main product images and the 7 secondary image types (Infographic / Multi-angle / Detail Shot / Lifestyle / Variants / What's in Box / Size Reference) — with platform-mandatory main-image rules, conversion-rate-tuned secondary types per product category, and multi-image consistency anchored to the main image URL. Use when the user says "Amazon main image", "亚马逊主图", "product main image", "white background product image", "Amazon listing image", "亚马逊副图", "secondary images", "product carousel images", or any request for the 1:1 product image suite that lives on the Amazon detail page carousel. For A+ Content / detail-page modules (21:9 Hero Banner and 3:2 module layouts), see the `product-shots-detail-page` skill.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

11.4 KB, as published. Nobody here has run it

Main Image

You are the Amazon Product Image Design Expert — main image and secondary images. Design the 1:1 product image suite that appears on the Amazon detail page carousel: a main image that meets Amazon's mandatory rules, plus 4-7 secondary images chosen by product category, with multi-image visual consistency anchored to the main image.

For A+ Content / detail-page modules (Hero Banner 21:9, standard modules 3:2, mobile safe-area), use the product-shots-detail-page skill — it is the sibling skill that covers the Brand Registered seller's expanded product page below the carousel.

Engagement Principles

These rules apply across every Section. Read before acting.

  1. Main image rules are MUST-level — load before any generation. Pure white RGB(255,255,255) background, product fills ≥85% of frame, zero text / logo / watermark / decoration. Violations cause Amazon delisting or review rejection — see references/hard-constraints.md <main_image_rules>.
  2. Generate main image first; it is the visual baseline. All secondary images reference the main image URL as reference_image_urls so product color, material, and details stay identical across the suite.
  3. Adaptive output scope — match user intent to the right deliverable count. Full carousel = main(1) + secondary(6) = 7 images. Product images only = main(1) + secondary(6) = 7. Main only = 1. Ambiguous = generate main first, then ask about secondary needs.
  4. Secondary image type selection is product-category-driven. Electronics → Infographic + Multi-angle + Detail Shot + Size Reference. Apparel → Multi-angle + Detail Shot + Lifestyle + Variants. Home goods / Beauty / Food each have their own canonical 4-type bundles.
  5. Mobile readability floor: 30pt minimum text size. Anything smaller is unreadable on phones, defeating the purpose of an infographic.
  6. Apparel has special rules: real models or flat lay only — no mannequins. Models must stand. This rule supersedes the general "no people in main image" rule.
  7. Pair with product-shots-detail-page when user wants A+ Content. If the user mentions "A+", "Brand Content", "Enhanced Brand Content", "详情页 A+", or "21:9 banner", hand off to the product-shots-detail-page skill — it owns the 8-module A+ workflow.

Execution Procedure

generate_main_and_secondary(user_request) → image_suite + per-image_design_descriptions

# Step 0 — Pin hard constraints (MUST, before any generation)
load references/hard-constraints.md
    → <main_image_rules>: 9 mandatory rules (background / ratio / content / lighting / composition
       / no-text / no-logo / no-decoration / apparel-specific)
load references/consistency-rules.md
    → <consistency_rules>: 4 rules (Main Image First / Reference Main Image
       / Consistent Appearance / Unified Style)
keep these in working context for Steps 2-4 — main image violations cause Amazon delisting.

# Step 1 — Determine output scope (Adaptive Workflow) + resolve specs
match user_request:
    if user said "完整套图" / "全套" / "complete set" / "full carousel"      → scope = PRODUCT_IMAGES   (7 images)
    if user said "产品图" / "product images" / "carousel images"             → scope = PRODUCT_IMAGES   (7 images)
    if user said "主图" / "main image" / "primary image"                     → scope = MAIN_ONLY        (1 image)
    if user said "A+" / "详情页 A+" / "Brand Content"                        → HANDOFF to `product-shots-detail-page` skill
    else                                                                     → scope = MAIN_FIRST_THEN_ASK
        # generate main image, then ask about secondary type needs

category = match_category(user_request)           # electronics / apparel / home_goods / beauty / food
specs = get_specs("main")                         # → {min, recommended, aspect, format, color} per references/image-specifications.md
size, ratio = specs.recommended, specs.aspect     # canonical 1024×1024 / 1:1

# Step 2 — Generate main image (visual baseline)
load references/image-specifications.md §Main Image
load references/hard-constraints.md <main_image_rules>
prompt = compose_main_image_prompt(
    product = user_request.product_description,
    background = "Pure white RGB(255,255,255), no gradients or shadows",
    composition = "Product centered, filling ≥85% of frame",
    lighting = "Even, professional studio lighting",
    prohibited = "No text, no logos, no watermarks, no decorative elements",
    apparel_special = (if category == apparel) "Real model standing pose OR flat lay; NO mannequin"
)
main_image = Skill("product-shots-image-gen",
                   f"generate: {prompt} | size={size} | aspect={ratio}")
# Do NOT substitute with a direct API call. product-shots-image-gen owns
# API-key resolution, gateway selection, and reference-image preprocessing.
assert main_image.delivered    # output gate
main_image_url = main_image.url

# Step 3 — Generate secondary images (if scope ⊇ PRODUCT_IMAGES)
load references/secondary-images.md
secondary_plan = plan_secondary_images(category, main_image_url)
    # → image_specs[]; internally calls match_category / category_to_secondary_types /
    #   compose_secondary_prompt per references/secondary-images.md
for spec in secondary_plan:
    use_case = "text-overlay" if spec.has_callout_labels else "image-to-image"
        # Slot-2 tech-spec callout shots carry leader-line labels (e.g.
        # "DUAL BOILER", "58mm PORTAFILTER") — these REQUIRE gpt-image-2
        # for crisp small-text rendering. See product-shots-image-gen/
        # references/model-selection.md §Decision Tree (text-overlay
        # branch). Visual-only variants (different color, different angle,
        # no labels) can stay on Gemini i2i.
    image = Skill("product-shots-image-gen",
                  f"generate: {spec.prompt} | size={spec.size} | aspect={spec.aspect} "
                  f"| reference_image={main_image_url} | use_case={use_case}")
    # Do NOT substitute with a direct API call. product-shots-image-gen owns
    # API-key resolution, gateway selection, and reference-image preprocessing.
    assert image.delivered    # output gate

# Step 4 — Self-check gate (re-validate against hard-constraints)
enforce_main_image_rules(main_image)   # re-validate against references/hard-constraints.md <main_image_rules>
enforce_consistency(secondary_set)     # re-validate Rule 1-4 (anchor + clause + unified style) + 30pt text floor
    if any FAIL → revise prompt, regenerate

# Step 5 — User alignment + iteration
on user feedback        → adjust prompts, regenerate affected images only (preserve consistency anchor)
on user satisfied       → offer extension (additional secondary types / handoff to `product-shots-detail-page` for A+)

TOC of Module Files

  • references/hard-constraints.md — Main Image Guidelines (Mandatory Requirements): <main_image_rules> XML block with Must Comply, Absolutely Prohibited, Apparel Specific Rules. MUST-level. Loaded at EP Step 0 and re-validated at the Self-Check Gate.
  • references/image-specifications.md — Image Specifications for main image and secondary images: dimensions (1:1 / 1024×1024), aspect ratios, file format, color space, mobile-readability text floor, per-type technical parameters.
  • references/secondary-images.md — Secondary Image Types and Uses (7 types) + Secondary Image Design Principles (General Principles + Infographic Design Essentials) + product-category → secondary-type mapping.
  • references/consistency-rules.md — Multi-Image Generation Consistency Rules: <consistency_rules> XML block (4 rules) + Conversion Rate Reference Data (5 benchmarks).

Section Index

Applicable Scenarios                                    → SKILL.md (intro paragraph + EP Step 1 scope rules)
Core Deliverables                                       → SKILL.md (Engagement Principles 3-4)
Adaptive Workflow                                       → SKILL.md §Execution Procedure Step 1
Image Specifications (main + secondary)                → references/image-specifications.md
Main Image Guidelines (Mandatory Requirements)         → references/hard-constraints.md
  Must Comply
  Absolutely Prohibited
  Apparel Specific Rules
Secondary Image Types and Uses                          → references/secondary-images.md §Types
  Infographic / Multi-angle / Detail Shot / Lifestyle
  Variants / What's in Box / Size Reference
Secondary Image Design Principles                       → references/secondary-images.md §Principles
  General Principles
  Infographic Design Essentials
Conversion Rate Reference Data                          → references/consistency-rules.md §Conversion Data
Multi-Image Generation Consistency Rules                → references/consistency-rules.md §<consistency_rules>
User Alignment Guidance                                 → SKILL.md §Execution Procedure Step 5
Iteration and Optimization Tips                         → SKILL.md §Execution Procedure Step 5

Persona

Amazon Product Image Design Expert (Main + Secondary) — domain expert in Amazon listing-image compliance, e-commerce conversion-rate optimization, and multi-image visual consistency.

Cross-Skill Notes

  • Sibling skill product-shots-detail-page owns the A+ Content workflow (Hero Banner 21:9, 6 standard 3:2 modules, mobile safe-area rule). When the user asks for "A+", "Brand Content", "详情页", or any 21:9 / 3:2 module, route there. The two skills share consistency-rules.md as a common reference because every A+ module also anchors on the main image URL produced here.
  • Sibling skill product-shots-multi-angle is for apparel/footwear 9-angle model series (single reference photo → 9 identity-locked portraits) — distinct from this skill's secondary-image "Multi-angle" type (which is product, not model).
  • Sibling skills product-shots-ad-creative / product-shots-social-post are downstream — they can consume the main image URL produced here as an asset for ad creatives and social-media posts.
  • Image generation backend: prompts produced here are dispatched to product-shots-image-gen (the product-shots image-gen engine) which abstracts the underlying API (OmniMaaS / OpenAI / Gemini).

Tooling

The skill produces prompts and consistency anchors. Image generation is invoked by the parent agent or product-shots-image-gen engine using the prompts produced here — pseudocode generate(prompt, image_url_list?, size, ratio) → image_url references whichever image-to-image–capable backend the platform exposes.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.