Agent skill

Ecom Details Image

by ZJU-REAL in ZJU-REAL/Easel

生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

Apache-2.0Auto-check: notesMedia & Creative

Install Ecom Details Image

skills CLI
$ npx skills add ZJU-REAL/Easel --skill ecom-details-image -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZJU-REAL/Easel ecom-details-image --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/ecom-details-image .claude/skills/ecom-details-image && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ecom-details-image
GitHub stars
3.4k
Token cost
~1.1k tokens
SKILL.md length
282 words
Files
34 (incl. scripts, references)
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

  • Works in 2 steps: Brief / Prompt 模式:只输出视觉简报和可执行图片 Prompt。 → Generate 模式:当用户明确要求"生图、生成图片、出图、render…
  • Tasks that involve Image generation
  • SKILL.md covers References(按需加载,不要一次性全读), 核心流程, 最小输入 and 生图脚本调用(scripts/generate_image.p…, plus 2 more sections
  • Calls python3; reaches api.apimart.ai; needs IMG_API_KEY and OPENAI_API_KEY

What it does

Ecom Details Image is an agent skill from ZJU-REAL/Easel. 生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt。 当用户说"商品主图""详情页视觉""电商配图方案""商品场景图""带货视觉""产品视觉方向""详情页设计"时使用。 本 SKILL 出视觉方案+生图 Prompt(策划);实际抠白底图用 remove-bg,实际生成图片用 ai-image-gen。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 35 other files, including scripts and reference files (for example `EASEL-META.md`, `references/campaign-style-lock.md` and `references/image-gen-rules.md`).

It sits in Media & Creative, covering Image generation. It works with OpenAI. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Image generation

Example prompts

  • “电商配图方案”
  • “产品视觉方向”
  • “/ecom-details-image”

Requirements

  • Python 3
  • A credential in IMG_API_KEY
  • A credential in OPENAI_API_KEY

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Brief / Prompt 模式:只输出视觉简报和可执行图片 Prompt。
  2. Generate 模式:当用户明确要求"生图、生成图片、出图、render image"时,先输出最终 Prompt,再调用 scripts/generate_image.py。

What it can do on your machine

Read from SKILL.md and the folder at commit ede33b8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.apimart.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • IMG_API_KEY
    • OPENAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ecom Details Image loads about 1.1k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 282 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~24k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:52
    `.claude/skills/ecom-details-image/` 放 `.env`,不要把真实 API key 写进仓库:
  • NoteMentions a .env fileSKILL.md:67
    age/scripts/generate_image.py --env-file .env --image product.jpg --prompt-file prompt.txt
  • NoteMentions a .env fileSKILL.md:76
    *不要调用脚本**,只输出完整 Prompt 包 + 配置命令示例,说明需要在 `.env` 里配置什么,交给用户自行运行。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ZJU-REAL/Easel at commit ede33b8, republished under its Apache-2.0 licence (© ZJU-REAL). 282 words, ~1,127 tokens.

Download SKILL.mdSave it as .claude/skills/ecom-details-image/SKILL.md (or your agent's skills folder). This skill also uses 33 other files; get the full folder from GitHub.
name
ecom-details-image
description
生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt。 当用户说"商品主图""详情页视觉""电商配图方案""商品场景图""带货视觉""产品视觉方向""详情页设计"时使用。 本 SKILL 出视觉方案+生图 Prompt(策划);实际抠白底图用 remove-bg,实际生成图片用 ai-image-gen。
layer
produce

ecom-details-image Skill

当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉,或要求直接 AI 生图时,使用这个 Skill。

两种模式:

  1. Brief / Prompt 模式:只输出视觉简报和可执行图片 Prompt。
  2. Generate 模式:当用户明确要求"生图、生成图片、出图、render image"时,先输出最终 Prompt,再调用 scripts/generate_image.py。

审美方向对齐 card-design:详情页信息图 / 营销图的视觉方向遵守同一套去 AI 廉价感原则——禁蓝紫科技渐变、禁 emoji 当图标、字大字细、留白克制、填满不空。把这些写进 Prompt 的正向/否定约束里(本 SKILL 出 t2i Prompt,非 HTML 渲染,故是"审美方向"层面对齐,不走 render_card)。

不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。

References(按需加载,不要一次性全读)

文件内容何时读
references/templates.md25 个场景模板匹配表、使用方式、风格变体速查判断场景类型、匹配模板时
references/templates/*.json具体场景模板(prompt_template/variants/category_tips/anti_ai_tips)只读匹配到的那一个
references/image-gen-rules.md通用 Prompt 结构、文生图铁律、精简原则、Anti-AI 技巧、翻车点防护写每一条 Prompt 时
references/campaign-style-lock.md多图任务的 Campaign Style Lock 规则与默认模板任务含多张图时
references/pdp-sequences.md转化驱动诊断、主图/详情页序列、多角度镜头、详情页信息图结构、字体搭配商品图/详情页/PDP 任务时

核心流程

  1. 判断视觉任务类型和场景 → 读 references/templates.md 匹配模板。
  2. 从 references/templates/ 读取匹配到的那一个 JSON,取 prompt_template、variants、category_tips 作为 Prompt 基础结构。
  3. 只收集会实质影响图片结果的缺失信息(见下方最小输入)。
  4. 构建视觉简报。
  5. 多图任务:先按 references/campaign-style-lock.md 建立 Campaign Style Lock,锁定整套图的色板、冷暖调、字体、背景、光线、布局和图标风格。
  6. 按 references/image-gen-rules.md 写出可执行图片 Prompt(保持简洁,逐条对照铁律);多图任务必须把同一段 Campaign Style Lock 原样放进每张 Prompt。
  7. 商品图/详情页/营销图:按 references/pdp-sequences.md 先做转化驱动力诊断,再排序列。
  8. 用户要求电商详情页 / PDP / 主图堆栈 / 整套商品图时,默认输出 5 张主图 + 7-9 张详情页图片 的图片包(详情页每屏必须是电商信息图格式,见 references/pdp-sequences.md)。
  9. 用户要求直接出图 → 调用 scripts/generate_image.py;用户提供参考产品图时传入 --image。
  10. 返回 Prompt、生成文件路径和关键假设。

最小输入

任何视觉任务优先确认:目标、用途(主图/广告图/社媒图/Banner/PDP 模块/缩略图等)、主体、受众与语境、风格、构图与比例、是否需要图内文字、负面约束。缺少非关键字段时,明确假设后继续,不要无谓阻塞。

生图脚本调用(scripts/generate_image.py)

直接生图走 apimart.ai 图像生成接口(模型由 IMG_MODEL 指定,model-agnostic,异步轮询);也可改用统一生图入口 skill ai-image-gen。优先在 .claude/skills/ecom-details-image/ 放 .env,不要把真实 API key 写进仓库:

dotenv
IMG_BASE_URL=https://api.apimart.ai/v1
IMG_MODEL=gpt-image-2
IMG_API_KEY=your-api-key

脚本兼容别名:OPENAI_BASE_URL、OPENAI_API_BASE、OPENAI_IMAGE_MODEL、OPENAI_MODEL、OPENAI_API_KEY。

调用形状:

bash
python3 skills/openclaw/ecom-details-image/scripts/generate_image.py --prompt "..." --size 1:1 --resolution 2k
python3 skills/openclaw/ecom-details-image/scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
python3 skills/openclaw/ecom-details-image/scripts/generate_image.py --env-file .env --image product.jpg --prompt-file prompt.txt

参数:--prompt / --prompt-file;--output-dir(仅用户指定时用,否则 generated-images/);--size(比例格式,14 种,如 1:1/16:9/2:3/4:5,默认 1:1);--resolution(1k/2k/4k,默认 2k,4K 仅限 6 个宽幅比例);--image(参考产品图路径,对保证产品外观准确非常有效);--poll-interval(默认 5);--timeout(默认 180);--format(默认 png)。

生图规则:

  1. 先输出最终 Prompt,再调脚本。短 Prompt 用 --prompt,长 Prompt 用 --prompt-file。
  2. 根据平台选 --size,没要求时默认 1:1。
  3. 缺少 IMG_API_KEY 等配置时不要调用脚本,只输出完整 Prompt 包 + 配置命令示例,说明需要在 .env 里配置什么,交给用户自行运行。
  4. 如果 API/模型不支持某尺寸,改用最接近的支持尺寸并说明。

QA 检查(输出前逐条确认)

  • Prompt 符合用户真实目标,已匹配正确场景模板并基于其 prompt_template 组装。
  • Prompt 简洁、只含核心信息,主体/构图/风格/用途明确。
  • 商品/营销任务包含转化驱动力诊断;证据缺失时不虚构效果、认证、数据、评分、销量、评价或授权。
  • 已应用文生图铁律:hex 颜色、数字占比、显式留白、否定清单、平台预留空间(详见 references/image-gen-rules.md)。
  • UGC/直播/社媒场景已应用 anti-AI 技巧(模板的 anti_ai_tips 字段)。
  • 多图任务:每张以同一段 Campaign Style Lock 开头;已分配不同角度和景别,无连续 3 张相同角度,全景图占比 ≤ 40%。
  • 详情页图片必须是电商信息图格式(含标题、图标、标签、利益点、步骤或信任徽章),每张详情页 Prompt 以 E-commerce infographic 开头,不是单纯多角度产品照片。
  • 图内文字短且必要;有用户参考图时已传 --image;负面约束覆盖常见失败点。
  • 输出和文件里没有 API key 或私密凭据。
  • 提醒用户出图后放大 200% 逐字核对中文笔画。

输出格式

Brief / Prompt 模式返回:

  1. 匹配模板(模板文件名 + 场景类型)
  2. Visual Brief
  3. Final Image Prompt
  4. Negative Constraints
  5. Assumptions

商品或营销任务追加:Conversion Driver Diagnosis、Campaign Style Lock(多图时)、Hero Image Sequence(标注每张对应模板)、PDP Detail Image Sequence(涉及详情页/PDP/整套商品图时)、Copy Lines(需要文字时)、Test Priorities。

Generate 模式返回:

  1. 匹配模板(模板文件名 + 场景类型)
  2. Final Image Prompt
  3. Campaign Style Lock(多图任务必须返回)
  4. Image Pack Plan(每张图的编号、用途、尺寸、对应模板和短文案)
  5. Generated Files
  6. Assumptions / Notes

© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 33 other files (scripts, references) in skills/openclaw/ecom-details-image of ZJU-REAL/Easel.

  • SKILL.md
  • .env.example
  • EASEL-META.md
  • references/campaign-style-lock.md
  • references/image-gen-rules.md
  • references/pdp-sequences.md
  • references/templates.md
  • references/templates/01-hero-image.json
  • references/templates/02-lifestyle-scene.json
  • references/templates/03-flat-lay.json
  • references/templates/04-detail-macro.json
  • references/templates/05-poster-banner.json
  • references/templates/06-social-media.json
  • references/templates/07-ugc-style.json
  • references/templates/08-model-showcase.json
  • references/templates/09-before-after.json
  • references/templates/10-packaging.json
  • references/templates/11-infographic.json
  • references/templates/12-creative-concept.json
  • … and 15 more

Open the folder on GitHubat commit ede33b8

Compare with similar skills

Ecom Details Image next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ecom Details Image compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ecom Details Image this skillZJU-REAL/Easel3.4k—~1.1kAutomated safety check: NotesApache-2.0
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
GPT Image Generation CLIwuyoscar/GPT-Image2-Skill5.7k—~2.5kAutomated safety check: NotesMIT
Imagegentheowenyoung/home1154 repos~4.8kAutomated safety check: PassApache-2.0
Openai Image Gentrpc-group/trpc-agent-go1.9k12 repos~843Automated safety check: PassApache-2.0
Image Generationonyx-dot-app/onyx32k1 repos~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • GPT Image Generation CLI

    wuyoscar/GPT-Image2-Skill

    Generates and edits images with GPT Image 2 or 2.5 through a packaged CLI and a prompt gallery, after settling which model fits the request.

    5.7k GitHub stars~2.5k tokensUpdated 11 days ago
    Media & CreativeAuto-check: notes
  • Imagegen

    theowenyoung/home

    Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts.

    115 GitHub starsUsed in 4 repos~4.8k tokens
    Media & CreativeAuto-check passed
  • Openai Image Gen

    trpc-group/trpc-agent-go

    Batch-generate images via OpenAI Images API. An agent skill from trpc-group/trpc-agent-go.

    1.9k GitHub starsUsed in 12 repos~843 tokens
    Media & CreativeAuto-check passed
  • Image Generation

    onyx-dot-app/onyx

    Generate or edit raster images (photos, illustrations, textures, sprites, mockups, logos, infographics) using the workspace's configured image-generation provider via onyx-cli image.

    32k GitHub starsUsed in 1 repo~1.7k tokens
    Media & CreativeAuto-check passed
  • BlockRun Image Generation

    BlockRunAI/ClawRouter

    Generates or edits images through ClawRouter's local image API, with a choice of models and sizes and payment handled automatically through x402.

    6.6k GitHub stars~2.1k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Paper Explainer

    ZJU-REAL/Easel

    科研论文解读:解析 arXiv/PDF 的公式与图表,提炼问题、贡献、方法、关键图和结论,再产出 B站/视频号解读视频或知乎/公众号图文。

    3.4k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Ecom Details Image

What does Ecom Details Image do?

生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel. Ecom Details Image is an agent skill from ZJU-REAL/Easel.

When should I use Ecom Details Image?

Ecom Details Image fits situations like: tasks that involve Image generation.

How do I install Ecom Details Image in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill ecom-details-image -a claude-code`. Or copy the skill folder (skills/openclaw/ecom-details-image in ZJU-REAL/Easel) into .claude/skills/ecom-details-image in your project. Claude Code loads it when a task matches its description.

How do I install Ecom Details Image in Codex?

Run `npx skills add ZJU-REAL/Easel --skill ecom-details-image -a codex`. Or copy the skill folder (skills/openclaw/ecom-details-image in ZJU-REAL/Easel) into .agents/skills/ecom-details-image in your project. Codex loads it when a task matches its description.

Can I use Ecom Details Image in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJU-REAL/Easel --skill ecom-details-image -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ecom-details-image, .gemini/skills/ecom-details-image, .github/skills/ecom-details-image and .opencode/skills/ecom-details-image in your project.

What does Ecom Details Image need to run?

Going by SKILL.md and its folder, Ecom Details Image needs the command-line tools its instructions call (python3) and credentials named IMG_API_KEY and OPENAI_API_KEY. Our summary lists: Python 3; A credential in IMG_API_KEY; A credential in OPENAI_API_KEY.

Does Ecom Details Image access the network?

SKILL.md names 1 domain. In commands or code: api.apimart.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Ecom Details Image safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ecom Details Image use?

Ecom Details Image is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ecom Details Image use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 23k tokens, read only when the agent opens those files.

What are the alternatives to Ecom Details Image?

Skills that share tags, products or a category with Ecom Details Image: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), GPT Image Generation CLI (wuyoscar/GPT-Image2-Skill, 5.7k stars), Imagegen (theowenyoung/home, 115 stars) and Openai Image Gen (trpc-group/trpc-agent-go, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ecom Details Image?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,441 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 11, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.