E-commerce 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:

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**:

**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**:

**Use AskUserQuestion** with questions:

**Question 1: Outline Strategy**

**Question 2: Visual Style**

**Question 3: Platform**

**Question 4: Scene Type**

**After response**:

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**:

**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

Shopify

eBay

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**:

**Presets**:

**Workflows**:

**Platforms**:

**Config**:

Notes

Extension Support

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