product-image-generator

name	product-image-generator
description	Generates professional product images for e-commerce platforms (Amazon, Shopify, eBay, etc.). Supports 8 visual styles and 6 scene types optimized for different product categories. Use when user mentions "商品图", "product images", "Amazon listing", "电商图片", or needs e-commerce product photography.
metadata	{"version":"1.0.0"}

E-commerce Product Image Generator

Create professional product images optimized for e-commerce platforms with platform-specific requirements and multiple visual styles.

Usage

# Auto-select style based on product
/product-image-generator product-description.md

# Specify style
/product-image-generator product.md --style minimal

# Specify platform (auto-adjusts image requirements)
/product-image-generator product.md --platform amazon

# Specify scene type
/product-image-generator product.md --scene studio

# Combine options
/product-image-generator product.md --style premium --platform shopify --scene lifestyle

# Direct input
/product-image-generator
[paste product description]

# Direct input with options
/product-image-generator --style minimal --scene studio
[paste product description]

# With reference image (for style consistency)
/product-image-generator product.md --ref brand-style.png

# Multiple reference images
/product-image-generator product.md --ref style.png --ref competitor.jpg

Options

Option	Description
--style <name>	Visual style (see Style Gallery)
--scene <type>	Scene type (see Scene Gallery)
--platform <name>	E-commerce platform (auto-adjusts requirements)
--ref <path>	Reference image(s) for style consistency

Three Dimensions

Dimension	Controls	Options
Style	Visual aesthetics: mood, color treatment	minimal, premium, lifestyle, bold, soft, tech, natural, luxury
Scene	Background and context	studio, lifestyle, contextual, exploded, comparison, infographic
Platform	Technical requirements	amazon, shopify, ebay, etsy, taobao, jd, pinduoduo

Style × Scene × Platform can be freely combined. Example: --style premium --scene lifestyle --platform amazon creates a high-end lifestyle shot meeting Amazon's image requirements.

Style Gallery

Style	Description	Best For
minimal (Default)	Clean, white background, focus on product	Electronics, accessories, professional products
premium	Sophisticated, elegant lighting, subtle shadows	Luxury goods, jewelry, high-end cosmetics
lifestyle	Product in natural use context	Home goods, fashion, outdoor products
bold	High contrast, vibrant, attention-grabbing	Sports products, gaming, youth-oriented items
soft	Gentle lighting, pastel tones, warm	Baby products, skincare, wellness items
tech	Futuristic, sleek, modern	Electronics, gadgets, software, AI products
natural	Organic, eco-friendly, earthy tones	Sustainable products, food, natural cosmetics
luxury	Gold accents, dramatic lighting, rich colors	Premium brands, jewelry, high-end fashion

Detailed style definitions: references/presets/<style>.md

Scene Gallery

Scene	Description	Image Count
studio (Default)	Pure white/gradient background, professional studio lighting	1-3 images
lifestyle	Product in real-life usage scenario	2-5 images
contextual	Product in environment, staged setting	2-4 images
exploded	Component breakdown, features highlighted	3-6 images
comparison	Before/after, product vs alternatives	2-4 images
infographic	Features, specs, benefits with text overlays	2-5 images

Detailed scene definitions: references/elements/scene-guide.md

Platform Requirements

Platform	Main Image	Additional Images	Notes
amazon	1000x1000+, pure white	Up to 9 images	Main image must be on pure white background
shopify	1024x1024+ recommended	Unlimited	Flexible, but 1:1 or 4:3 recommended
ebay	500x500+ minimum	Up to 12 free	White background preferred
etsy	760x760+	Up to 10 images	Lifestyle shots perform well
taobao	800x800+	Up to 15 images	Infographic style popular
jd	800x800+	Up to 15 images	Clean, professional style
pinduoduo	750x750+	Up to 10 images	Value-focused presentation

Platform-specific guidelines: references/platforms/<platform>.md

Auto Selection

Product Category	Style	Scene
Electronics, gadgets	tech or minimal	studio + exploded
Fashion, accessories	premium or lifestyle	lifestyle + contextual
Beauty, cosmetics	soft or premium	studio + lifestyle
Home, furniture	lifestyle or natural	contextual + lifestyle
Sports, outdoor	bold or lifestyle	lifestyle + contextual
Jewelry, luxury	luxury or premium	studio + lifestyle
Baby, kids	soft or natural	lifestyle + contextual
Food, supplements	natural or minimal	studio + infographic
Tools, hardware	bold or tech	exploded + infographic

Outline Strategies

Strategy A: Product-Focused (产品聚焦型)

Aspect	Description
Concept	Product as hero, clean presentation
Features	Multiple angles, detail shots, pure backgrounds
Best for	Electronics, accessories, luxury items
Structure	Hero shot → Angle variations → Detail close-ups → Scale/context

Strategy B: Lifestyle-Focused (场景融入型)

Aspect	Description
Concept	Product in natural use environment
Features	Context-rich, emotional connection, aspirational
Best for	Home goods, fashion, outdoor products
Structure	Lifestyle hero → Usage scenario → Benefits in context → Social proof

Strategy C: Information-Focused (信息传达型)

Aspect	Description
Concept	Features and benefits clearly communicated
Features	Text overlays, callouts, comparisons
Best for	Complex products, tools, supplements
Structure	Hero with key benefit → Feature breakdown → Comparison → Specs/usage

File Structure

Each session creates an independent directory named by product slug:

product-images/{product-slug}/
├── source-{slug}.{ext}             # Source files (description, reference images)
├── analysis.md                     # Product analysis + positioning
├── outline-strategy-a.md           # Strategy A: Product-focused
├── outline-strategy-b.md           # Strategy B: Lifestyle-focused
├── outline-strategy-c.md           # Strategy C: Information-focused
├── outline.md                      # Final selected/merged outline
├── prompts/
│   ├── 01-hero-[slug].md
│   ├── 02-detail-[slug].md
│   └── ...
├── 01-hero-[slug].png
├── 02-detail-[slug].png
└── NN-infographic-[slug].png

Slug Generation:

1. Extract product name (2-4 words, kebab-case)
2. Example: "无线蓝牙耳机" → wireless-earbuds

Conflict Resolution: If product-images/{product-slug}/ already exists:

• Append timestamp: {product-slug}-YYYYMMDD-HHMMSS

Workflow

Progress Checklist

Product Image Generation Progress:
- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] Step 1: Analyze product → analysis.md
- [ ] Step 2: Confirmation 1 - Product understanding ⚠️ REQUIRED
- [ ] Step 3: Generate 3 outline + style variants
- [ ] Step 4: Confirmation 2 - Outline & style & platform ⚠️ REQUIRED
- [ ] Step 5: Generate images (sequential)
- [ ] Step 6: Completion report

Flow

Input → [Step 0: Preferences] ─┬─ Found → Continue
                               │
                               └─ Not found → First-Time Setup ⛔ BLOCKING
                                              │
                                              └─ Complete setup → Save EXTEND.md → Continue
                                                                                      │
        ┌─────────────────────────────────────────────────────────────────────────────┘
        ↓
Analyze → [Confirm 1] → 3 Outlines → [Confirm 2: Outline + Style + Platform] → Generate → Complete

Step 0: Load Preferences (EXTEND.md) ⛔ BLOCKING

Purpose: Load user preferences or run first-time setup.

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.

Use Bash to check EXTEND.md existence:

# Check project-level first
test -f .teamclaw-skills/product-image-generator/EXTEND.md && echo "project"

# Then user-level
test -f "$HOME/.teamclaw-skills/product-image-generator/EXTEND.md" && echo "user"

Result	Action
Found	Read, parse, display summary → Continue to Step 1
Not found	⛔ BLOCKING: Run first-time setup → Save EXTEND.md → Step 1

First-Time Setup (when EXTEND.md not found):

Use AskUserQuestion with ALL questions in ONE call:

1. Default platform preference: amazon / shopify / ebay / etsy / taobao / jd / pinduoduo / no preference
2. Default style preference: minimal / premium / lifestyle / bold / soft / tech / natural / luxury
3. Watermark: Enable / Disable (if enable, specify text and position)
4. Language: Chinese / English / Auto-detect

Schema: references/config/preferences-schema.md

Step 1: Analyze Product → analysis.md

Actions:

1. Save source content:
   • If file path provided: use as-is
   • If pasted content: save to source.md
   • Backup rule: If exists, rename to source-backup-YYYYMMDD-HHMMSS.md
2. Read and analyze product information
3. Product analysis:
   • Category identification
   • Target audience
   • Key features and selling points
   • Competitive positioning
   • Visual opportunities
4. Detect product language
5. Determine recommended image count and types
6. Generate clarifying questions (see Step 2)
7. Save to analysis.md

Step 2: Confirmation 1 - Product Understanding ⚠️

Purpose: Validate understanding + collect missing info.

Display summary:

• Product category identified
• Key features extracted
• Target audience
• Recommended platform match

Use AskUserQuestion for:

1. Primary selling point (multiSelect: true):

   • Design/aesthetics
   • Functionality/features
   • Price/value
   • Quality/durability
   • Brand/status
   • Innovation/technology
   • Sustainability/eco-friendly
   • Convenience/ease of use

2. Target customer:

   • Budget-conscious
   • Quality-focused
   • Luxury/premium
   • Tech-savvy
   • Eco-conscious
   • Family-oriented
   • Professional/business
   • Youth/trend-focused

3. Main use scenario:

   • Indoor/home
   • Outdoor
   • Office/work
   • Travel
   • Sports/fitness
   • Social/events
   • Auto

4. Additional context (optional)

After response: Update analysis.md → Step 3

Step 3: Generate 3 Outline + Style Variants

Create three distinct strategy variants, each with outline structure and visual style recommendation.

Strategy	Filename	Focus	Recommended Style
A	outline-strategy-a.md	Product-focused	minimal, tech
B	outline-strategy-b.md	Lifestyle-focused	lifestyle, soft, natural
C	outline-strategy-c.md	Information-focused	bold, infographic-style

Outline format (YAML front matter + content):

---
strategy: a  # a, b, or c
name: Product-Focused
style: minimal
style_reason: "Clean presentation highlights product design and build quality"
scene: studio
platform: amazon
image_count: 5
---

## P1 Hero Shot
**Type**: hero
**Purpose**: Main product image, first impression
**Visual**: Product on pure white background, professional lighting
**Platform**: Amazon main image compliant (1000x1000, pure white)

## P2 Angle Variation
**Type**: angle
**Purpose**: Show product from different perspective
**Visual**: 45-degree angle, slight shadow for depth

## P3 Detail Close-up
**Type**: detail
**Purpose**: Highlight key feature or quality detail
**Visual**: Macro shot of texture/material/connection point

...

After response: Update analysis.md → Step 3

Step 4: Confirmation 2 - Outline & Style & Platform Selection ⚠️

Purpose: User chooses strategy, confirms style and platform.

Display each strategy:

• Strategy name + image count + recommended style
• Image-by-image summary

Use AskUserQuestion with questions:

Question 1: Outline Strategy

• Strategy A (Product-focused)
• Strategy B (Lifestyle-focused)
• Strategy C (Information-focused)
• Combine: specify images from each

Question 2: Visual Style

• Use strategy's recommended style
• Or select from: minimal / premium / lifestyle / bold / soft / tech / natural / luxury
• Or type custom style description

Question 3: Platform

• Use strategy's recommended platform
• Or select: amazon / shopify / ebay / etsy / taobao / jd / pinduoduo
• Custom: specify requirements

Question 4: Scene Type

• Use strategy's recommended scene
• Or select: studio / lifestyle / contextual / exploded / comparison / infographic

After response:

• Single strategy → copy to outline.md with confirmed settings
• Combination → merge specified images
• Update outline.md frontmatter with final settings

Step 5: Generate Images

With confirmed outline + style + scene + platform:

Visual Consistency — Reference Image Chain:

1. Check for user-provided reference images (--ref option)

   • If provided: Use as primary style reference
   • If not provided: Use internal reference chain (see below)

2. Internal Reference Chain (when no user ref provided):

   • Generate image 1 (hero) FIRST — without --ref
   • Use image 1 as --ref for ALL remaining images (2, 3, ..., N)

For each image:

1. Save prompt to prompts/NN-{type}-[slug].md
   • Backup rule: If exists, rename to prompts/NN-{type}-[slug]-backup-YYYYMMDD-HHMMSS.md
   • Include reference image paths in prompt
2. Generate image:
   • With user ref: --ref <user-reference.png> for all images
   • Image 1 (no user ref): Generate without --ref (establishes visual anchor)
   • Images 2+ (no user ref): Generate with --ref <image-01-path>
   • Backup rule: If image exists, rename with timestamp
3. Report progress after each generation

Reference Image Best Practices:

Reference Type	Usage	Effect
Style reference	Brand guideline images	Maintains brand consistency
Competitor reference	Similar product images	Matches category standards
Internal chain (image 1)	First generated image	Ensures series consistency

Platform Compliance:

• Apply platform-specific requirements automatically
• Amazon: Pure white background for main image
• Size adjustments based on platform

Session Management: Use consistent session ID for all images in the set: product-{slug}-{timestamp}

Step 6: Completion Report

Product Image Set Complete!

Product: [product name]
Strategy: [A/B/C/Combined]
Style: [style name]
Scene: [scene type]
Platform: [platform] (requirements applied)
Location: [directory path]
Images: N total

✓ analysis.md
✓ outline-strategy-a.md
✓ outline-strategy-b.md
✓ outline-strategy-c.md
✓ outline.md (selected: [strategy])

Files:
- 01-hero-[slug].png ✓ Main image ([platform] compliant)
- 02-angle-[slug].png ✓ Angle variation
- 03-detail-[slug].png ✓ Detail shot
...

Image Modification

Action	Steps
Edit	Update prompt file FIRST → Regenerate with same session ID
Add	Specify position → Create prompt → Generate → Renumber files
Delete	Remove files → Renumber subsequent → Update outline

Platform-Specific Guidelines

Amazon

• Main image: Pure white background (RGB 255,255,255)
• Minimum 1000x1000 pixels for zoom feature
• Product must fill 85%+ of frame
• No text, logos, or watermarks on main image
• Additional images: lifestyle, infographic, comparison allowed

Shopify

• Recommended 1024x1024 or 4:3 aspect ratio
• More flexible styling
• Lifestyle images perform well
• Consistent style across all product images

eBay

• Minimum 500x500 pixels
• White background preferred but not required
• Up to 12 free images per listing

Content Breakdown Principles

1. Hero Image (Image 1): Main product shot, platform-compliant
2. Angle Variations: Show product from multiple perspectives
3. Detail Shots: Highlight quality, features, materials
4. Lifestyle/Context: Product in use, emotional connection
5. Infographic: Features, specs, benefits with callouts
6. Comparison: Before/after, vs alternatives
7. Social Proof: Reviews, testimonials (if applicable)

References

Detailed templates in references/ directory:

Elements:

• elements/scene-guide.md - Scene types and compositions
• elements/lighting.md - Lighting setups and moods
• elements/composition.md - Framing and composition rules

Presets:

• presets/<style>.md - Style definitions and prompts

Workflows:

• workflows/analysis-framework.md - Product analysis
• workflows/outline-template.md - Outline templates
• workflows/prompt-assembly.md - Prompt assembly

Platforms:

• platforms/amazon.md - Amazon requirements
• platforms/shopify.md - Shopify requirements
• platforms/ebay.md - eBay requirements
• platforms/etsy.md - Etsy requirements
• platforms/taobao.md - Taobao requirements
• platforms/jd.md - JD.com requirements
• platforms/pinduoduo.md - Pinduoduo requirements

Config:

• config/preferences-schema.md - EXTEND.md schema
• config/watermark-guide.md - Watermark configuration

Notes

• Auto-retry once on failure
• Platform requirements auto-applied
• Two confirmation points required (Steps 2 & 4)
• Reference image chain ensures visual consistency

Extension Support

Custom configurations via EXTEND.md. See Step 0 for paths.