product-image-generator

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

Three Dimensions

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

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

Scene Gallery

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

Platform Requirements

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

Auto Selection

Outline Strategies

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

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

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

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"

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.

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:

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

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.