ecommerce-image-workflow
Reference-product ecommerce image workflow for generating a compact set of product-faithful main, feature, and lifestyle images from real product reference photos. V1 requires uploaded product imagery and intentionally defers brief-only concept generation and platform-specific batch exports.
By nexu-io · 1,657 installs
npx skills add nexu-io/open-design --skill ecommerce-image-workflow
Source repository · Upstream listing
Ecommerce Image Workflow
Create a compact ecommerce image set from real product reference imagery.
This V1 skill is intentionally narrow: it supports reference product mode
only . If the user only describes a product and does not provide a product
photo, ask for one and stop. Do not create a brief only concept product in
this version.
Resource map
What this skill produces
By default, generate three ecommerce ready image assets for one product:
1. Main image clean product first packshot on white or soft neutral
background.
2. Feature image one selling point shown clearly with controlled callout
space, without relying on tiny unreadable in image text.
3. Lifestyle image product shown in a plausible use context while keeping
the product faithful to the reference.
Also create:
image manifest.json describing reference inputs, slots, prompts, outputs,
aspect ratios, and fidelity notes.
ecommerce gallery.html as a small preview gallery linking the generated
files and summarizing the image roles.
Input contract
Required:
At least one uploaded product reference image in the active project.
Ask only for missing essentials:
Product name or short label if it is not obvious.
Main selling point if the feature image cannot be inferred safely.
Target marketplace or aspect only if the user asks for platform specific
framing.
Do not ask broad discovery questions. Keep the workflow moving.
Workflow
Step 0 Confirm reference product mode
Before planning, verify that the current project includes a real product
reference image.
If no product image is available, reply:
Please upload at least one product reference image first. This V1 workflow
preserves a real product from reference photos; brief only concept generation
is deferred to a later version.
Then stop.
Step 1 Extract product identity anchors
Inspect the reference image and write a short internal identity lock:
Product category and form factor.
Shape and silhouette.
Primary colors and materials.
Logo, label, pattern, fasteners, ports, straps, handles, or other fixed
details.
Scale cues and proportions.
What must not change.
Use these anchors in every generation prompt.
Step 2 Build a three slot shot plan
Create a compact shot plan before dispatch:
Slot Default aspect Goal
:
main 1:1 Product first marketplace image on white or soft neutral background
feature 4:5 One clear selling point with close up detail or simple callout space
lifestyle 4:5 Realistic use context with the product still visually faithful
If the project metadata provides imageAspect , use it when the user expects a
single aspect across the set. Otherwise use the slot defaults above.
Step 3 Compose prompts with a fidelity lock
Every prompt must include this product fidelity instruction near the top:
Then add slot specific instructions:
Main image prompt
Product centered and fully visible.
White, off white, or very light grey background.
Soft studio lighting with clean shadow.
No props unless the user asked for them.
No in frame marketing text.
Feature image prompt
Focus on one user provided or safely inferred feature.
Use close up composition, cutaway style crop, or clean negative space for
later designer added labels.
Keep the product visually balanced in the frame. If no explicit callout
structure is being generated, center the product. If label space is needed,
offset the product only slightly and make the empty space feel intentional.
Do not invent certifications, performance numbers, materials, or claims.
Avoid tiny rendered text; leave label space instead.
Lifestyle image prompt
Use a realistic environment matched to the product category.
Keep the product the focal point.
Show human interaction only if it helps explain use and does not obscure the
product.
Preserve product scale and structure.
Step 4 Dispatch through the media contract
Use the unified OpenDesign media dispatcher. Do not call provider APIs or
custom model commands directly.
For each slot, run the standard generate/wait loop:
The final line must be JSON with {"file": {"name": "...", ...}} .
Record each final returned filename in image manifest.json .
If the active image model or provider cannot use image , stop and tell the
user that this workflow needs a reference capable image generation path for
product fidelity.
Step 5 Write image manifest.json
After generation, create a project file named image manifest.json :
Keep the manifest honest. If a detail is unknown, write null or a short note
instead of inventing claims.
Step 6 Write ecommerce gallery.html
Create a simple single file HTML gallery that:
Shows the reference image first.
Shows the three generated slots with their role names.
Lists product fidelity notes.
Links to image manifest.json .
Uses system fonts and local project files only; no CDN imports.
Step 7 Hand off
Reply with:
The generated filenames.
A one sentence summary of the fidelity lock used.
A reminder that marketplace specific compliance, final text overlays, and
claim/legal review remain human review steps.
Do not emit an <artifact tag.
Hard rules
V1 requires real product reference imagery. No brief only concept products.
One product per run.
Default to exactly three slots: main, feature, lifestyle.
Preserve the product; do not redesign it.
Do not invent claims, certifications, measurements, ingredients, or
performance data.
Use "$OD NODE BIN" "$OD BIN" media generate ; do not call provider APIs
directly.
Always create image manifest.json after generation.
Run references/checklist.md before handoff.