Skywork Design
by @gxcun17
Skywork Design (skywork) - Generate or edit images via the Skywork Image API. Use for image creation, poster design, logo design, visual asset generation, or...
clawhub install skywork-design📖 About This Skill
name: Skywork Design description: Skywork Design (skywork) - Generate or edit images via the Skywork Image API. Use for image creation, poster design, logo design, visual asset generation, or image modification requests. Supports text-to-image and image-to-image editing with aspect ratio and resolution control. metadata: openclaw: requires: bins: - python3 env: - SKYWORK_API_KEY primaryEnv: SKYWORK_API_KEY
Visual Design — Image Generation & Editing
Generate new images or edit existing ones via the backend image API. Be patient, it takes about 2 minutes to generate an image each time.
Prerequisites
API Key Configuration (Required First)
This skill requires a SKYWORK_API_KEY to be configured before use.If you don't have an API key yet, please visit: https://skywork.ai
For detailed setup instructions, see: references/apikey-fetch.md
Usage
Run the script using absolute path (do NOT cd to skill directory):
Generate new image:
python3 /scripts/generate_image.py --prompt "description" --filename "output.png" [--aspect-ratio 3:4] [--resolution 1K|2K|4K]
Edit existing image:
python3 /scripts/generate_image.py --prompt "edit instructions" --filename "output.png" --input-image "source.png" [--aspect-ratio 3:4] [--resolution 2K]
Edit with multiple reference images:
python3 /scripts/generate_image.py --prompt "combine these styles" --filename "output.png" -i "ref1.png" -i "ref2.png"
Always run from the user's working directory so images save there.
When to Generate vs Edit
--prompt only): Creating new images from scratch — posters, logos, illustrations, photos, infographics.--prompt + --input-image): User provides existing image(s) and wants modifications — style changes, element addition/removal, color adjustments, format conversion.If the user uploads/references images and wants changes, always use --input-image.
Resolution
Map user requests: "low/draft" → 1K, "normal/medium/2K" → 2K, "high-res/hi-res/4K/ultra" → 4K.
Aspect Ratio
Supported ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
Selection guidance:
If the user doesn't specify, omit --aspect-ratio and let the API decide.
Filename Convention
Pattern: yyyy-mm-dd-hh-mm-ss-descriptive-name.png
Examples:
2026-03-10-14-23-05-japanese-garden.png2026-03-10-15-30-12-sunset-mountains.png2026-03-10-17-12-48-x9k2.pngPreflight
command -v python3 (must exist)--input-image file existsCommon Failures
Error: Input image not found: → wrong path; verify --input-image file existsHTTP error 500 → backend service error; retry or check server statusRequest failed: Connection refused → backend service unavailable; ensure the service is runningInsufficient benefit. Please upgrade your account at {url}, meaning the user's benefit level does not meet the requirement for this skill.How to reply when benefit is insufficient
When you detect the above, reply in the user's current language — do not echo the English message. Use this pattern:
Upgrade now → or the equivalent in their language.at https://... part).> Note: Only suggest upgrading when the error is Insufficient benefit. For auth errors like NO_TOKEN / INVALID_TOKEN / 401 / “invalid API key”, keep the error code / raw message and guide users to update SKYWORK_API_KEY. Do not suggest upgrading membership.
Output
Design Scenarios
Match the user's request to a scenario and read the corresponding file for specialized workflow:
Prompt Engineering
Prompts Best Practices
Follow these principles for quality prompts using the image API for generation or editing:
💡 Examples
Run the script using absolute path (do NOT cd to skill directory):
Generate new image:
python3 /scripts/generate_image.py --prompt "description" --filename "output.png" [--aspect-ratio 3:4] [--resolution 1K|2K|4K]
Edit existing image:
python3 /scripts/generate_image.py --prompt "edit instructions" --filename "output.png" --input-image "source.png" [--aspect-ratio 3:4] [--resolution 2K]
Edit with multiple reference images:
python3 /scripts/generate_image.py --prompt "combine these styles" --filename "output.png" -i "ref1.png" -i "ref2.png"
Always run from the user's working directory so images save there.
⚙️ Configuration
API Key Configuration (Required First)
This skill requires a SKYWORK_API_KEY to be configured before use.If you don't have an API key yet, please visit: https://skywork.ai
For detailed setup instructions, see: references/apikey-fetch.md