/install easy-image
easy-image
Silently translate user's simple descriptions into professional prompts, call image generation APIs, return professional-grade images.
First-time Setup
If ~/.easy-image-skill/config.json not exists, guide user through 4 steps:
- Select Platform — Jiekou AI(recommended for China) / Novita / PPIO / OpenRouter / WaveSpeed / Google Imagen. Details:
references/platforms/*.md - API Key — Check
~/.{platform}/config.json, auto-detect existing key or ask user to provide - Storage Path — ~/Downloads(default) / ~/Desktop / Custom. This grants blanket download authorization
- Frequent Scenes (optional) — PPT / Posters / Product Photos / Social Media / Avatar
Save to ~/.easy-image-skill/config.json: {"platform":"jiekou","save_path":"~/Downloads","frequent_scenes":[...]}
Workflow
1. Parse Input
Extract: scene(PPT/poster/product/social media), channel(→auto size, see Channel Mapping below), subject, style, details. If incomplete, ask only what's missing.
2. Match Personal Library
Silently check ~/.easy-image-skill/my-prompts.md for scene+keyword match. No match → use references/templates/{scene}.md.
3. Translate to Professional Prompt
Load template from references/templates/{scene}.md, fill variables, add smart defaults. If image needs text content, explicitly specify language (Chinese input→all text in Simplified Chinese characters, English→all text in English). Terminology: references/glossary.md
4. Select Model
Rules in references/model-selection.md. Summary:
- Default: Gemini 3.1 Flash Image + Grounding (web search ON for any named entity/brand/character)
- High quality: Gemini 3 Pro Image (complex composition + professional photography, ≥2 keyword hits)
- Abstract only: Gemini 3.1 Flash Image without Grounding (pure color/shape descriptions)
5. Show Enhancement Summary
One line before generating: ◇ {template} | +{2-4 key enhancements added}
6. Call API
Platform details: references/platforms/{platform}.md. Hide all technical details from user. Show: ◐ Generating...
7. Save & Display
Auto-download to configured save_path (pre-authorized). Display image immediately, download in background. File naming: {scene}_{brief}_{timestamp}.png
8. Handle Feedback
Satisfied ("good"/"save"/"perfect") → async save to personal library. Adjust request → modify prompt, regenerate. Max 3 adjustment rounds.
Channel Size Mapping
| Channel | Ratio | Channel | Ratio |
|---|---|---|---|
| WeChat Moments | 1:1 | Xiaohongshu | 3:4 |
| WeChat Video/Douyin | 9:16 | PPT/Presentation | 16:9 |
| WeChat Article header | 2.35:1 | Taobao main image | 1:1 |
Config Commands
Users can say: "switch to Novita" / "my key is sk-xxx" / "save to desktop" / "show config" / "reset config"
UX Rules
- Auto-detect language (Chinese ratio>0.3 → zh)
- Monochrome status icons: ◇ ◐ ◉ ● (no technical details shown to user)
- Prompts always in English; UI messages follow user language
- Personal library saves are async and non-blocking
Reference Documents
| Doc | Purpose |
|---|---|
references/model-selection.md |
Model selection rules & keywords |
references/glossary.md |
Professional terminology |
references/platforms/*.md |
Platform API configs |
references/templates/*.md |
Scene prompt templates |
examples/usage-examples.md |
Usage examples |
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install easy-image - 安装完成后,直接呼叫该 Skill 的名称或使用
/easy-image触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Easy Image 是什么?
Professional image generation assistant for workplace: PPT graphics, marketing posters, product photos, social media content. Simple description → Profession... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 263 次。
如何安装 Easy Image?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install easy-image」即可一键安装,无需额外配置。
Easy Image 是免费的吗?
是的,Easy Image 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Easy Image 支持哪些平台?
Easy Image 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Easy Image?
由 bbear(@ximasadila)开发并维护,当前版本 v1.0.1。