| name | product-illustrator |
| description | Product illustration and rendering for ecommerce, instruction manuals, and marketing. Use when tasks involve creating product images from CAD files (CadQuery, OpenSCAD), generating marketing renders or lifestyle mockups, illustrating assembly instructions or user guides, creating Etsy/ecommerce listing images, rendering 3D-printed product photography, or producing visual assets for product pages. Combines CAD rendering with ComfyUI image generation for polished output. Works with STL files, .scad files, and CadQuery Python scripts.
|
Product Illustrator
Generate product images from CAD source files for marketing, ecommerce listings, instruction manuals, and packaging. Bridges parametric CAD (CadQuery, OpenSCAD) with AI image generation (ComfyUI) for production-quality visual assets.
Operating context
This skill serves product teams producing visual assets for ecommerce storefronts, marketing sites, and instruction manuals. It is designed for workflows where products originate as parametric CAD models (3D-printed goods, manufactured parts, consumer products) and need polished imagery for customer-facing channels.
Typical roles that interact with this pipeline:
| Role | Responsibility |
|---|
| Product Lead | Product strategy, ecommerce, CAD modeling |
| Manufacturing / Print Operator | Print execution, slicer config, quality |
| Creative Director | Final approval on visual assets |
Infrastructure
Configure the following environment variables to connect to your rendering services:
| Variable | Default | Purpose |
|---|
COMFYUI_HOST | localhost | Hostname of the ComfyUI server |
COMFYUI_PORT | 8188 | Port for the ComfyUI API |
OUTPUT_DIR | ./output | Base directory for generated images |
CAD_LIB_PATH | (none) | Additional library path for CadQuery (e.g., $HOME/.local/lib) |
ComfyUI endpoint: http://${COMFYUI_HOST}:${COMFYUI_PORT}
If CadQuery requires additional shared libraries, set LD_LIBRARY_PATH before running:
export LD_LIBRARY_PATH="${CAD_LIB_PATH}:$LD_LIBRARY_PATH"
CAD tools
| Tool | Status | Use |
|---|
| CadQuery (Python) | Primary, installed | Parametric modeling, direct STL export, headless rendering |
| SolidPython2 | Available | Python wrapper for OpenSCAD syntax, generates .scad files |
| OpenSCAD | Binary not installed | Can read .scad files via SolidPython2, but use CadQuery for STL export |
| Shapr3D | Available (local) | Manual CAD modeling |
Pipeline overview
CAD Source Rendering Enhancement
+----------------+ +------------------+ +------------------+
| CadQuery (.py) | STL | CadQuery render | PNG | ComfyUI |
| OpenSCAD (.scad)| -----> | or | -----> | (style transfer, |
| STL files | | Blender headless | | background, |
+----------------+ +------------------+ | enhancement) |
+------------------+
|
+------+-------+
| |
Marketing Instruction
renders manual images
Reading CAD files
CadQuery Python files (.py)
CadQuery scripts are parametric -- they define geometry through code. To understand a product:
- Read the
.py file to extract parameters (dimensions, tolerances, materials)
- Identify the key components (frames, inserts, connectors, etc.)
- Note the export calls (
cq.exporters.export()) to find what STLs are generated
import cadquery as cq
result = cq.Workplane("XY").box(100, 50, 10)
cq.exporters.export(result, "output/part.stl")
cq.exporters.export(result, "output/part_front.svg",
opt={"projectionDir": (0, 0, 1)})
cq.exporters.export(result, "output/part_side.svg",
opt={"projectionDir": (1, 0, 0)})
cq.exporters.export(result, "output/part_iso.svg",
opt={"projectionDir": (1, 1, 1)})
OpenSCAD files (.scad)
If given a .scad file, read it to understand the geometry. Key syntax:
// Primitives
cube([width, depth, height]);
sphere(r=radius);
cylinder(h=height, r=radius);
// Transforms
translate([x, y, z]) { ... }
rotate([rx, ry, rz]) { ... }
scale([sx, sy, sz]) { ... }
// Boolean operations
union() { ... } // Combine shapes
difference() { ... } // Subtract second from first
intersection() { ... } // Keep only overlap
// Parametric
module part_name(param1, param2) { ... }
Since OpenSCAD binary isn't installed, convert to CadQuery for rendering, or describe the geometry for ComfyUI prompt generation.
STL files
STL files are mesh data -- they can't be read as source code. For STL-only products:
- Note the filename convention to understand what the part is
- Use CadQuery's STL import:
cq.importers.importStep("part.stl")
- Or render with a headless tool and pass to ComfyUI
Rendering with CadQuery
Orthographic views (for instruction manuals)
import cadquery as cq
model = cq.importers.importStep("product.step")
cq.exporters.export(model, "front.svg",
opt={"projectionDir": (0, -1, 0), "width": 800, "height": 600})
cq.exporters.export(model, "top.svg",
opt={"projectionDir": (0, 0, 1), "width": 800, "height": 600})
cq.exporters.export(model, "iso.svg",
opt={"projectionDir": (1, -1, 1), "width": 800, "height": 600})
Exploded views (for assembly instructions)
import cadquery as cq
frame = build_frame()
insert = build_insert().translate((0, 0, 30))
connector = build_connector().translate((0, 0, 60))
assembly = cq.Assembly()
assembly.add(frame, name="frame")
assembly.add(insert, name="insert", loc=cq.Location((0, 0, 30)))
assembly.add(connector, name="connector", loc=cq.Location((0, 0, 60)))
ComfyUI enhancement
After generating base renders from CAD, use ComfyUI to produce polished marketing images.
ComfyUI endpoint: http://${COMFYUI_HOST}:${COMFYUI_PORT}
See the concept-art skill for full ComfyUI API details. The key differences for product illustration:
Marketing renders
Transform CAD renders into photorealistic product shots:
Prompt structure:
"professional product photography, {product description},
{material/finish}, studio lighting, white background,
soft shadows, high-key lighting, commercial photography,
8k, sharp focus, {angle}"
Example prompts by product type:
3D-printed decorative product:
"professional product photography, geometric decorative wall panel,
intricate lattice pattern, matte PLA finish, warm studio lighting,
clean white background, soft shadows, lifestyle interior setting,
modern minimalist decor, commercial product shot"
Product on white background (for Etsy/ecommerce):
"product photography on pure white background, {product},
even studio lighting, no shadows, isolated product,
ecommerce listing style, clean, sharp, professional"
Lifestyle context (for marketing sites):
"interior design photography, {product} mounted on modern wall,
living room setting, natural window light, scandinavian style,
lifestyle product photography, editorial quality"
Instruction manual illustrations
For clean technical illustrations:
"technical illustration, {assembly step description},
clean line art, instruction manual style, numbered callouts,
white background, clear and simple, isometric view,
assembly diagram, no shading"
Or enhance CAD SVG exports:
"clean technical diagram, product assembly illustration,
exploded view, {parts description}, minimal style,
numbered parts, clear arrows showing assembly direction,
instruction booklet quality"
Image types and specifications
Etsy / Ecommerce listings
| Image | Resolution | Format | Requirements |
|---|
| Main listing | 2000x2000 | PNG/JPG | White or lifestyle background, product fills 80% of frame |
| Detail shot | 2000x2000 | PNG/JPG | Close-up of texture, pattern, finish |
| Scale reference | 2000x2000 | PNG/JPG | Product with common object for size context |
| Lifestyle | 2000x2000 | PNG/JPG | Product in real setting (room, desk, wall) |
| Process/materials | 2000x2000 | PNG/JPG | Filament, printer, unboxing |
Etsy allows up to 10 images per listing. Recommended set:
- Hero shot (product on white)
- Lifestyle context (product in room)
- Detail/texture close-up
- Scale reference
- Color variants (if applicable)
- Assembly/usage illustration
- Packaging/unboxing
Instruction manual images
| Image | Resolution | Format | Style |
|---|
| Assembly step | 1200x900 | SVG or PNG | Line art, numbered callouts, isometric |
| Parts list | 1200x900 | SVG or PNG | All parts laid out, labeled |
| Completed product | 1200x900 | PNG | Clean render, all angles |
| Warning/note | 600x400 | SVG or PNG | Icon-based, clear symbols |
Marketing site renders
| Image | Resolution | Format | Style |
|---|
| Hero banner | 2560x1440 | PNG/WebP | Dramatic lighting, lifestyle setting |
| Product grid | 800x800 | PNG/WebP | Consistent white background, uniform framing |
| Feature callout | 1200x800 | PNG/WebP | Close-up with annotation overlay |
| Comparison | 1600x900 | PNG/WebP | Before/after or variant comparison |
Workflow by deliverable
Ecommerce listing images
- Read the CAD source to understand the product geometry and variants
- Generate orthographic renders from CadQuery for accurate product views
- Enhance with ComfyUI for white-background studio shots
- Generate lifestyle images with ComfyUI for context shots
- Create detail crops focusing on textures, patterns, material finish
- Confirm with operator before using for listings
Assembly instructions
- Read the CAD source and identify all parts and assembly sequence
- Generate exploded views showing parts separated along assembly axis
- Render each assembly step with relevant parts highlighted
- Add callout annotations (part numbers, arrow directions)
- Export as SVG or clean PNG for print and digital manual use
- Number steps sequentially with clear "before" and "after" states
Marketing site renders
- Read the CAD source to understand the product
- Generate hero renders from the best angles
- Use ComfyUI to create photorealistic renders with dramatic lighting
- Create lifestyle contexts (product in real-world settings)
- Generate multiple colorways/variants if applicable
- Output at web-optimized sizes (WebP for web, PNG for print)
Naming conventions
output/
{project}/
product/
ecommerce/
listing_{product}_{variant}_{number}.png -- Etsy/shop images
lifestyle_{product}_{setting}_{number}.png -- Context shots
manual/
step_{NN}_{description}.svg -- Assembly steps
parts_list.svg -- Parts overview
exploded_{view}.svg -- Exploded diagrams
marketing/
hero_{product}_{angle}_{number}.png -- Hero banners
grid_{product}_{variant}.png -- Product grid tiles
feature_{product}_{detail}.png -- Feature callouts
renders/
ortho_{product}_{view}.svg -- Orthographic views from CAD
iso_{product}.svg -- Isometric views from CAD
Use filename_prefix in ComfyUI's SaveImage node to route output automatically.
Sampler settings for product images
| Use case | Model | Steps | CFG | Resolution | Notes |
|---|
| White background product | flux-2-klein-9b | 25 | 7 | 1024x1024 | Clean, even lighting |
| Lifestyle context | flux2_dev | 30 | 7 | 1216x832 | More detail for environments |
| Technical illustration | flux-2-klein-4b | 15 | 8 | 1024x1024 | Higher CFG for precision |
| Quick variant exploration | flux1-schnell | 10 | 5 | 768x768 | Fast batch generation |
Related skills
| Skill | Hand off when |
|---|
| concept-art | Exploring visual direction before committing to product renders |
| ue5-gamedev | Product needs real-time 3D visualization (beyond static renders) |
| corporate-vp | Product launch decisions needing executive analysis |
