Details
Overview
Ecom Details Image is an open-source visual creation Skill for cross-border and domestic e-commerce, built for Claude Code / Codex / OpenClaw. It generates complete e-commerce image sets — product main images, Amazon/Shopify detail pages, social media posts and livestream scenes — from a single product photo and a natural-language description, using any OpenAI-compatible image generation API (such as GPT-Image-2).
Key Features
- All-in-one e-commerce image generation: product heroes, Amazon/Shopify PDP images, social promotion, livestream scenes and more.
- 25 scene templates: white-background hero shots, lifestyle, flat lay, detail close-ups, poster banners, social UGC, model shots, before/after, packaging, infographics, size charts, multi-product combos, livestream, virtual try-on, exploded views and more.
- Campaign Style Lock: locks color palette, warm/cool tones, fonts, backgrounds, lighting and layout across a set so the whole campaign stays visually consistent.
- Conversion-driven diagnosis: auto-detects whether a product is visual-driven, pain-point-driven or emotional-value-driven, and generates the corresponding image sequence.
- Reference image support: passes a real product photo to the API so generated visuals match the actual item.
- Prompt / Generate dual modes: output prompts only for manual use, or call the API directly to render images.
- Zero-dependency script: pure Python standard-library implementation — no pip install needed.
How to Use
- Use a Skill-compatible agent such as Claude Code, Cursor, or Codex.
- Install from the terminal (Node.js required):
npx skills add https://github.com/liangdabiao/ecom-details-image
Or paste the install prompt from this tool page into your agent and ask it to install for you. 3. Restart / reload the agent so the new Skill is loaded. 4. Invoke the Skill with its slash commands or by asking the agent to run the workflow described in Overview / Key Features. 5. Review outputs before publishing — treat model-generated copy, images, and data as drafts.
Pricing
Free open-source project (MIT-style public repo). You only pay for the image generation API you connect (e.g., OpenAI GPT-Image-2 or any OpenAI-compatible service).
Integrations
- Claude Code CLI, Codex, OpenClaw
- OpenAI-compatible image APIs (OpenAI, Azure OpenAI or third-party providers)
- Local: Python 3.10+ and configured API key via .env
Best For
Cross-border and domestic e-commerce sellers, marketers and designers who want fast, consistent, conversion-oriented product image sets without manual design work.
FAQ
What is Ecom Details Image?
A Skill that automates e-commerce image generation — main images, PDP detail pages, social posts and livestream scenes — via Claude Code/Codex/OpenClaw and an OpenAI-compatible image API.
Does it cost anything?
The project is free; you only pay for the image generation API you use.
How does Campaign Style Lock work?
It generates one style-lock text (colors, tone, fonts, background, lighting, layout) and prepends it to every image prompt so the whole set stays consistent.
What do I need to run it?
Claude Code/Codex/OpenClaw installed, Python 3.10+, and an OpenAI-compatible image API key.