What it does
一个面向workbuddy / Codex 等agent 的跨境电商和国内电商通用视觉创作 Skill。我精选25个高质量案例,涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等,全部配完整提示词,都可以利用 GPT-Image-2 、Seedream 5.5 API生成最终效果。一键生成电商相关图片!输入产品图片和需求描述,自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。 与众不同之处是:**Campaign Style Lock** 机制 和 **强推广** 和 **重视转化效果**。
- Connects Instruction files the AI reads, with steps that call an outside service
- Account or key Some steps need a key for APIZ_API_KEY, IMG_API_KEY, OpenAI (per the README)
- Category Automation and agents
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/liangdabiao-ecom-details-image)Similar Skills
Same kind of work, ordered like the Skills list
1 skills (instruction sets) by liangdabiao that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude CodeCodex
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account liangdabiao (person), 14 years old
- Use and upkeep
★ 1,731 stars · code last changed Nov 14, 2026
- Any scripts?
2 scripts that can run on a computer: scripts/generate_image.py, scripts/generate_image_dreamina.py
- Uses the internet?
Scripts that go online: scripts/generate_image.py
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 64e30d8 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Download from GitHub
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the ecom-details-image folder again. The ZIP must have a ecom-details-image folder with SKILL.md at the top level, no loose files
Open Skills on claude.ai and upload
+Create skillUpload a skillpick ecom-details-image.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /ecom-details-image or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/liangdabiao/ecom-details-image.git /tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8/.' ~/.claude/skills/ecom-details-imageRestart Claude Code, then type /ecom-details-image or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the ecom-details-image folder at ~/.agents/skills/ecom-details-image
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/liangdabiao/ecom-details-image.git /tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8/.' ~/.agents/skills/ecom-details-image
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/liangdabiao/ecom-details-image.git /tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8/.' ~/.agents/skills/ecom-details-imageRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick ecom-details-image
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/liangdabiao/ecom-details-image.git /tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-liangdabiao-ecom-details-image-64e30d8/.' ~/.cursor/skills/ecom-details-imageIn Cursor’s Agent chat, type / and pick ecom-details-image
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 18, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
Showing the first 8,000 characters · Open the full file on GitHub
---
name: ecom-details-image
description: Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images, marketing creatives, social posts, ads, ecommerce PDP visuals, and general visual design tasks. Use when the user asks for visual strategy, image prompt writing, product/marketing image direction, or direct text-to-image generation. In Codex environments use the built-in imagegen tool; elsewhere use the bundled script, which prefers the dreamina-canvas CLI (Seedream 5.5) and falls back to the apiz CLI.
---
# ecom-details-image Skill
当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉,或要求直接 AI 生图时,使用这个 Skill。
这个 Skill 有两种模式:
1. **Brief / Prompt 模式**:只输出视觉简报和可执行图片 Prompt。
2. **Generate 模式**:当用户明确要求“生图、生成图片、出图、render image”时,先输出最终 Prompt,再按下方**生图通道判断**选择生成方式。
不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。
---
## 生图通道判断(Generate 模式必读)
直接生图前必须先判断当前运行环境,选择对应通道:
### 通道 A:Codex 环境 → agent 内置 imagegen
**判断方法**:检查你自己(agent)当前会话中是否具备内置的 `imagegen` 工具。有,说明你在 Codex 环境。
执行方式:
1. 不要调用 `scripts/generate_image.py`,直接调用内置 `imagegen` 工具。
2. 把最终 Prompt(含 Campaign Style Lock)作为 `prompt` 传入;工具如支持比例/尺寸参数,传入对应比例。
3. 如果用户提供了参考产品图,按 imagegen 工具的参考图/编辑参数传入。
4. 把返回的图片文件记录为 Generated Files;建议将文件移动或复制到 `generated-images/<产品slug>/` 目录,与本 Skill 的输出习惯保持一致。
5. imagegen 不可用或调用失败时,回退到通道 B。
### 通道 B:非 Codex 环境 → 即梦 dreamina-canvas CLI(默认优先)
claude code / OpenClaw 等其他环境使用 `scripts/generate_image.py`,默认(`--channel auto`)优先走**即梦通道**:脚本转交 `scripts/generate_image_dreamina.py`,内部调用 **dreamina-canvas CLI** 在即梦画布内生成,默认模型 **Seedream 5.5**。
前置条件(本机通常已就绪):
1. 已安装 dreamina-canvas CLI(`dreamina-canvas --version` 可执行)。
2. 已登录:`dreamina-canvas auth login` 完成 OAuth。认证完全由 CLI 处理,脚本不接触密钥。
可选配置(通过 `.env` 或环境变量,全部可省略):
```dotenv
DREAMINA_IMAGE_MODEL=seedream_5.5
# DREAMINA_CANVAS_ID=<画布UUID> # 不设置时用当前画布或自动创建 ecom-details-image 画布
DREAMINA_RESOLUTION=2K
DREAMINA_CREDIT_CEILING=10
# DREAMINA_BIN=C:\path\to\dreamina-canvas.exe
```
能力要点:
- 模型用 `dreamina-canvas model list --type image` 实时查询;Seedream 5.5 支持文生图/图生图、`1:1/3:4/4:3/16:9/9:16/2:3/3:2/21:9`、`1.5K/2K`、单节点 1-8 张、参考图最多 10 张、Prompt 上限 5000 字符。
- 不支持的比例如 `4:5` 脚本会自动换算到最接近的支持比例(`3:4`)并说明。
- **多参考图是即梦通道的优势**:用户提供了多角度产品图时,用多个 `--image` 传入(最多 10 张),产品一致性显著更好。
- 计费按即梦积分:Seedream 5.5 实测 2K 约 **6 积分/张**(`dreamina-canvas auth account` 查余额)。批量出图前先报预计积分消耗并经用户确认。
- 国内版产物左上角带「AI生成」合规水印,交付前提醒用户。
- 即梦 CLI 未安装或未登录时回退通道 C,不要阻塞:返回完整 Prompt 包和 `dreamina-canvas auth login` 指引。
### 通道 C:非 Codex 环境 → apiz CLI(回退)
即梦 CLI 不可用,或显式 `--channel apiz` / `ECOM_IMAGE_CHANNEL=apiz` 时,脚本内部调用 **apiz CLI**(https://apiz.ai)提交生成任务并下载结果,不再直连任何 HTTP API。
前置条件(本机通常已就绪):
1. 已安装 apiz CLI(`apiz --version` 可执行)。
2. 已登录:`apiz auth login` 保存过 API key,或设置了 `APIZ_API_KEY` 环境变量。认证完全由 CLI 处理,脚本不接触密钥。
可选配置(通过 `.env` 或环境变量,全部可省略):
```dotenv
APIZ_IMAGE_MODEL=apiz/gpt-image-2.5-flare
# APIZ_API_KEY=sk-xxx # 仅未使用 apiz auth login 时需要
# APIZ_BASE_URL=https://api.apiz.ai
# APIZ_BIN=C:\path\to\apiz.exe
```
- `APIZ_IMAGE_MODEL`:apiz 图片模型 id,默认 `apiz/gpt-image-2.5-flare`(GPT Image 2.5,支持参考图编辑、10 种比例、1K/2K/4K)。兼容旧别名 `IMG_MODEL`、`OPENAI_IMAGE_MODEL`、`OPENAI_MODEL`。
- 其他可用模型用 `apiz models list` 查看(category=image),如 `fal-ai/nano-banana-pro`、`apiz/gpt-image-2.5-sunburst`。
- 旧变量 `IMG_API_KEY`、`IMG_BASE_URL` 仍被兼容读取。
生图脚本:
```bash
python3 scripts/generate_image.py --prompt "clean product hero image..." --size 1:1
python3 scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
python3 scripts/generate_image.py --env-file .env --prompt-file prompt.txt
```
**参考图片**:如果用户提供了本地产品照片路径,使用 `--image` 参数传入;脚本会先 `apiz upload` 上传到 apiz CDN 换取公网 URL,再走图生图,这对保证产品外观准确非常有效。已有公网 URL 时用 `--image-url` 直接传入。
**注意**:生图会消耗 apiz 账户积分(`apiz account balance` 查看)。批量出图前先把 Image Pack Plan 报给用户确认。
如果 apiz CLI 未安装或未登录,不要阻塞:返回完整 Prompt 包,并给出安装/登录指引(`apiz auth login`),方便用户稍后自行运行。
---
## 核心流程
1. 判断视觉任务类型和场景(见下方**场景模板系统**)。
2. 从 `references/templates/` 匹配对应模板,读取 `prompt_template`、`variants`、`category_tips` 作为 Prompt 基础结构。
3. 只收集会实质影响图片结果的缺失信息。
4. 构建视觉简报。
5. 如果任务包含多张图,先建立 **Campaign Style Lock**,锁定整套图的色板、冷暖调、字体、背景、光线、布局和图标风格。
6. 写出可执行图片 Prompt(**保持简洁**,见下方 Prompt 精简原则);多图任务必须把同一段 Campaign Style Lock 原样放进每张 Prompt。
7. 如果任务是商品图、详情页图或营销图,先做转化驱动力诊断。
8. 如果用户要求电商详情页、PDP、主图堆栈或整套商品图,默认输出 **5 张主图 + 7-9 张详情页图片** 的图片包。
9. 如果用户要求直接出图,按**生图通道判断**执行:Codex 环境用内置 imagegen;其他环境调用 `scripts/generate_image.py`(默认即梦 Seedream 5.5,回退 apiz)。用户提供了参考产品图时,Codex 传给 imagegen,脚本通道传 `--image`(即梦支持多张 `--image` 重复传入)。
10. 返回 Prompt、生成文件路径和关键假设。
---
## 最小输入
任何视觉任务都优先确认这些信息:
- 目标:图片要达成什么效果。
- 用途:商品主图、广告图、社媒图、Banner、PDP 模块、缩略图、概念图等。
- 主体:产品、人物、场景、物体或抽象概念。
- 受众和使用语境。
- 风格:真实摄影、编辑部风格、高级棚拍、UGC、3D 渲染、插画等。
- 构图、比例、平台尺寸。
- 是否需要图片内文字。
- 负面约束:避免 logo、避免文字、避免杂乱、避免医疗承诺等。
如果缺少非关键字段,明确假设后继续,不要无谓阻塞。
---
## 通用图片 Prompt 结构
默认用英文写 Prompt,除非用户要求其他语言。
Prompt 按这个结构组织:
1. Campaign Style Lock,多图任务必填且每张图完全一致。
2. 主体和场景。
3. 图片目的和情绪意图。
4. 构图、镜头和取景。
5. 光线、颜色、材质和纹理。
6. 风格和真实感等级。
7. 平台限制和画幅比例。
8. 图片内文字处理。
9. 负面约束。
Prompt 要足够具体,可以直接执行;也不要过度规定无关细节,避免和用户目标冲突。
---
## GPT-Image-2 Prompt 铁律(必须遵守)
以下规则来自大量实战验证,每条 Prompt 都必须逐条检查。
### 1. 颜色用 hex 码,不用形容词
"白底"出来是淡灰,"金色"出来有 8 种金。必须写 hex:
- 白底 → `#FFFFFF`
- 深灰文字 → `#2D2D2D`
- 金色强调 → `#D4AF37`
- 浅米色背景 → `#F5F1E8`
- 深绿背景 → `#1A3A2E`
### 2. 产品占比必须数字化
不同图型的产品占比黄金区间:
| 图型 | 产品占比 | 说明 |
|---|---|---|
| 白底主图 | 35-40% | 太小显廉价,太大显拥挤 |
| 卖点副图 | 25-30% | 左图右文布局,产品在左 |
| 场景氛围图 | 20-25% | 场景图不是产品图,氛围才是主角 |
| 信息流广告 | 40% | 环境干扰多,产品要更突出 |
| 搜索广告 | 45% | 搜索图比信息流再大一点 |
| SKU 多规格卡 | 60-70%(整体) | 多个产品横排 |
### 3. 留白必须显式声明
不写留白,AI 一定把画面填满。每张图必须写:
- 白底主图 / 卖点副图 / 广告图:`留白至少 45%`
- 场景氛围图:`留白至少 50%`
- 详情页长图:`留白 50%+`
### 4. 否定清单不能省
每条 Prompt 结尾必须加负面约束,写具体禁止项而不是笼统的"不要多余的":
```
不要添加:道具、手、水印、假 logo、额外文字、装饰元素、渐变背景
```
### 5. 平台预留空间
国内电商主图必须预留:
- `顶部中央 200×100 区域留空(平台价格叠加区)` — 不写产品会把整个画面填满
- `左上角 200×100 像素区域完全留白` — logo 区域(如需要)
### 6. 3 层信息架构
电商图内文字必须遵循:
- 核心承诺 ≤15 字(主标题)
- 关键证据 2-3 个(图标 + 短标签)
- 行动指令 ≤8 字(CTA 按钮)
### 7. 批量出图优于反复调参
一次批量出图,让 CTR 数据选风格,不要凭审美反复调参。
---
## Prompt 精简原则
**GPT-Image-2 在结构清晰、信息具体的 Prompt 下表现最佳。**
- 只包含核心信息,去除冗余约束和重复描述。
- 自然语言优于关键词堆砌。
- 明确描述材质纹理(磨砂玻璃、拉丝金属、哑光饰面、丝绸光泽)。
- 始终包含光线方向和质量,场景图指定色温(如 `色温 5500K`)。
- 不要在一个 Prompt 里塞入太多场景、风格、情绪要求。
- 如果用户提供了参考产品图,传入 `--image` 比文字描述更有效。
- 中文字用「」中文引号包裹,渲染准确率明显高于英文引号或无引号。
- 复杂笔画的中文字(赢、鬱、餮等)尽量换成简单同义字,95% 准确率不是 100%。
---
## 场景模板系统
`references/templates/` 目录包含 25 个场景模板,每个模板提供 `prompt_template`、`variants`(风格变体)、`category_tips`(品类建议)、`examples` 和 `anti_ai_tips`。
### 模板匹配表
| 触发词 | 模板文件 |
|---|---|
| 白底图, 主图, hero image, packshot | `01-hero-image.json` |
| 场景图, 生活图, lifestyle | `02-lifestyle-scene.json` |
| 平铺图, flat lay, 俯拍 | `03-flat-lay.json` |
| 细节图, 微距, macro, 特写 | `04-detail-macro.json` |
| 海报, poster, banner, 促销 | `05-poster-banner.json` |
| 社交媒体, 小红书, Instagram, TikTok | `06-social-media.json` |
| UGC, 买家秀, GRWM | `07-ugc-style.json` |
| 模特, model, 人物展示 | `08-model-showcase.json` |
| 对比, before after, 前后 | `09-before-after.json` |
| 包装, packaging, 礼盒 | `10-packaging.json` |
| 信息图, A+, 详情页 | `11-infographic.json` |
| 创意, 概念, creative | `12-creative-concept.json` |
| 尺寸, 规格, 使用步骤 | `13-size-spec.json` |
| 套装, 组合, bundle | `14-multi-product.json` |
| 直播, livestream | `15-livestream.json` |
| 试穿, 融入, try on | `16-try-on-virtual.json` |
| 拆解图, 爆炸图, exploded view | `17-exploded-view.json` |
| 隐形模特, ghost mannequin, 3D服装 | `18-ghost-mannequin.json` |
| 多角度, 网格, grid, 多色展示 | `19-multi-angle-grid.json` |
| 杂志, 封面, editorial, magazine | `20-magazine-editorial.json` |
| 季节, 四季, campaign, 春夏秋冬 | `21-seasonal-campaign.json` |
| 奢华, 氛围, 烟雾, luxury, atmospheric | `22-luxury-atmospherics.json` |
| 设备模型, 界面, mockup, SaaS, APP | `23-device-mockup.json` |
| 店铺, 门面, 空间, storefront, 实体店 | `24-storefront.json` |
| 运动, 健身, sports, fitness | `25-sports-campaign.json` |
无匹配 → 默认 `01-hero-image.json`。**只读取匹配到的模板文件**,不要一次性加载全部。
### 模板使用方式
1. 取 `prompt_template` 作为 Prompt 基础结构。
2. 用用户产品信息替换 `{variables}`。
3. 用户指定风格变体 → 应用 `variants.<name>.overrides`。
4. 已知产品品类 → 应用 `category_tips.<category>`。
5. 简化:只保留有值的字段,输出简洁的自然语言 Prompt。
### 风格Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 1,731
- Maker
- liangdabiao
- License
- No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
- Last code change
- Nov 14, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1
- Topics
- agent-skill, agent-skills, skill, skills