Description

Professional image generation assistant for workplace: PPT graphics, marketing posters, product photos, social media content. Simple description → Profession...

README (SKILL.md)

easy-image

Name: Easy Image
Author: ximasadila

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

Usage Guidance

This skill appears to do what it says: translate short descriptions into professional prompts and call image-generation platforms. Before installing or using it, consider the following: - Review where API keys will be stored: the skill asks you to provide platform keys and will save them to platform-specific files in your home directory (e.g., ~/.jiekou/config.json). If you prefer, use limited-scope or ephemeral keys and check the file contents after setup. - Inspect the platform adapter docs (references/platforms/*.md) in the bundle (or ask the publisher) to see exact endpoints the skill will call. These endpoints determine where your prompts and any web-search queries are sent. - Be aware the skill defaults to 'Grounding' (web/image search) for many prompts. That means the skill will make outbound search requests (and potentially include prompt or entity text) whenever brand names, 'latest', or similar tokens are detected. If you have privacy concerns, disable grounding or avoid sending sensitive content. - The skill silently reads your personal library (~/.easy-image-skill/my-prompts.md) and may reuse prompts without explicit, per-use disclosure. If you keep sensitive or proprietary prompts, review and control that file. - The skill auto-downloads generated images to a configured path (default ~/Downloads). Choose a path you control and be cautious granting blanket download behavior. If any of the above is unacceptable, ask the publisher for an explicit list of external endpoints and an option to disable silent reuse or web-grounding. If you proceed, prefer using least-privilege API keys and regularly review the saved config files.

Capability Analysis

Type: OpenClaw Skill Name: easy-image Version: 1.0.1 The skill bundle is classified as suspicious due to high-risk credential handling and instructions that prioritize stealth over transparency. Specifically, SKILL.md directs the agent to 'auto-detect' API keys by searching for configuration files belonging to other applications (e.g., ~/.jiekou/config.json) and requests 'blanket download authorization' for sensitive user directories like ~/Downloads or ~/Desktop. Furthermore, the instructions explicitly command the agent to perform prompt translations and API calls 'silently' while 'hiding all technical details' from the user, which obscures the agent's behavior during high-privilege operations involving third-party AI platforms.

Capability Assessment

✓ Purpose & Capability

Name/description (image generation for workplace assets) aligns with behavior: assembling prompts from templates, selecting models, calling external image-generation platforms, and saving outputs. The skill expects API keys and local config files (e.g., ~/.{platform}/config.json and ~/.easy-image-skill/config.json), which is reasonable for this purpose. It does not request unrelated credentials or system-level privileges.

ℹ Instruction Scope

Runtime instructions read and write files in the user's home (~/.easy-image-skill/* and ~/.{platform}/config.json) and silently consult a personal library (~/.easy-image-skill/my-prompts.md). These actions are coherent with a personal prompt library and local config, but the SKILL.md explicitly says some checks happen 'silently' and that technical details are hidden from the user — this can be a privacy/visibility concern (the skill may read user prompt history and reuse it without making all details visible). It also defaults to enabling web-grounding/search when brand names or timeliness are detected, which implies automatic outbound network queries beyond the image generation API.

✓ Install Mechanism

Instruction-only skill with no install spec or downloaded code. That minimizes disk/write and supply-chain risk. All behavior is specified in SKILL.md and local reference docs.

ℹ Credentials

The registry metadata lists no required env vars, but the runtime flow clearly expects the user to provide platform API keys (e.g., Jiekou, Novita, PPIO, OpenRouter, WaveSpeed, Google) and stores them in platform-specific config files in the home directory. Requesting/storing those keys in user config files is proportionate, but the skill does not declare these credentials up-front in the registry metadata—this is an omission to be aware of. The skill does not request unrelated keys or system secrets.

✓ Persistence & Privilege

The skill does not request 'always: true' and does not modify other skills or system-wide settings. It writes its own config (~/.easy-image-skill/config.json) and personal library, which is expected. It also asks for a default 'save_path' granting blanket download authorization into a user-chosen folder; that is functional for its purpose but is a potential place for accidental data writes.

Version History

v1.0.1

3 ## v1.0.1 (2026-03-20) 4 5 ### Fixed 6 - Corrected Novita API endpoints: text-to-image now uses `/v3/gemini-3.1-flash-image-text-to-image` instead of non-existent `/v3/gemini-3.1-flash-imag e` 7 - Corrected PPIO API endpoints: same fix applied for both Flash and Pro models 8 - Fixed Pro model endpoints for both platforms: `/v3/gemini-3-pro-image-text-to-image` 9 10 ### Improved 11 - Compressed SKILL.md from ~12k to ~3.7k characters (~70% reduction) 12 - Removed duplicated pseudocode, flowcharts, and examples that already exist in reference files 13 - Cleaner skill structure saves context window for actual image generation work

v1.0.0

easy-image 1.0.0 - Initial release of the easy-image professional image generation assistant. - Guided, step-by-step first-time setup supporting multiple major image generation platforms. - Converts simple user requests into professional prompts for high-quality workplace images (PPT, marketing, product photos, social media, etc.). - Remembers and prioritizes user preferences, frequent use cases, and custom templates. - Streamlined workflow: natural language input → smart analysis → model selection → automatic image output. - Automatic handling of image storage location and permission for seamless future usage.

Metadata

Slug easy-image

Version 1.0.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 2

Frequently Asked Questions

What is Easy Image?

Professional image generation assistant for workplace: PPT graphics, marketing posters, product photos, social media content. Simple description → Profession... It is an AI Agent Skill for Claude Code / OpenClaw, with 263 downloads so far.

How do I install Easy Image?

Run "/install easy-image" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Easy Image free?

Yes, Easy Image is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Easy Image support?

Easy Image is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Easy Image?

It is built and maintained by bbear (@ximasadila); the current version is v1.0.1.

More Skills

Easy Image