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 ```bash # 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: ```bash # 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): ```yaml --- 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.