Product Image Generator

Generates professional product images for e-commerce platforms (Amazon, Shopify, eBay, etc.). Supports 8 visual styles and 6 scene types optimized for differ...

Security Scan

The documentation aligns with an e‑commerce product‑image helper, but the runtime instructions are vague about how images are actually produced and they reference reading/writing user config files and invoking a local binary that is not included — review before installing or giving filesystem access.

Purpose & Capability

Name/description and the large set of documentation files are coherent for an image‑generation/creative workflow. However, the skill claims to 'generate images' but provides no code, no install, and no explicit image generation backend (no API calls, no model, no included binary). The SKILL.md examples call a /product-image-generator executable and show generated image files, but that binary or any image engine is not part of the package — this gap should be justified by the author (e.g., requires a separate image generator or platform service).

Instruction Scope

Runtime instructions reference reading and writing preferences (EXTEND.md) at both project (.teamclaw-skills/) and user ($HOME/.teamclaw-skills/...) paths, instruct the agent to run a local '/product-image-generator' command, and assume the ability to create files under product-images/. The skill metadata declared no required config paths, but the instructions clearly touch the user's filesystem. The SKILL.md is also vague about the actual image generation step (which tool/API to call), leaving broad discretionary behavior to the agent.

Install Mechanism

There is no install spec and no code to download or execute from external URLs, which reduces supply‑chain risk. Because it's instruction-only, nothing in the manifest will automatically be written to disk by an installer. The remaining risk is runtime: the instructions expect a binary or external tool to exist.

Credentials

The skill requests no environment variables or credentials (good). However, it expects to save and load preference files at project and user locations (e.g., $HOME/.teamclaw-skills/product-image-generator/EXTEND.md) without those paths being declared in metadata; this grants the skill write access to the user's home directory which should be considered before use.

Persistence & Privilege

always:false and no special privileges are requested. The skill will persist user preferences in its own config files (EXTEND.md) if the agent follows the instructions — that is a normal behavior for a user‑level tool and not an elevated privilege.

What to consider before installing

This skill's docs and presets look legitimate for producing e‑commerce images, but important runtime details are missing. Before installing or running it: 1) Ask the author what actually generates the PNGs (local binary, local image model, or an external API) and whether any network calls will be made; 2) Confirm the exact filesystem paths it will read/write and whether you are comfortable allowing writes to $HOME/.teamclaw-skills/ and your project directory; 3) If the skill needs an external image API or binary, require the author to declare that and any credential requirements; 4) Run first in an isolated/test environment (or sandbox) so it cannot unexpectedly modify other files; 5) If you accept it, review the created EXTEND.md and generated prompts to ensure no sensitive information is being recorded or transmitted.

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.