sudoprivacy/image-generation

Image Generation Skill

Generate new images or edit existing images via the images API.

When to Use

Trigger this skill when the user asks to:

• Generate / create / draw / design a new image ("generate an image of a cat", "draw me a sunset")
• Edit / modify / alter an existing image ("change the background to white", "add a hat to the person")
• Transform a referenced image ("make the above image black and white", "修改上面的图片")

Steps

Step 1: Determine operation type

• Generation: User describes a new image to create (no source image referenced)
• Edit: User references an existing image to modify

Step 2: For edits — identify the source image

• If the user provides a local file path, use it directly.
• If the user provides an image URL (http/https), download it first:

  curl -sL "<url>" -o /tmp/source_image.<ext>
  

• If the user references a previous image without a path (e.g. "the above image", "上面的图"):
  1. List files in the workspace matching common image extensions (*.png, *.jpg, *.jpeg, *.gif, *.webp, *.bmp)
  2. Sort by modification time (most recent first)
  3. Use the most recent image. If there are multiple candidates and it's ambiguous, ask the user which image they mean.

Step 3: Run the image generation script

For generation (new image):

1. Determine output path stem: run pwd first to get the session workspace path, then construct an absolute path with a concise name (e.g. /session/workspace/white_cat). If the user specifies a location, use that absolute path instead.
2. Execute:

   bash skills/image-generation/scripts/generate_image.sh gen "<prompt>" "<absolute_filepath_no_ext>" [size]
   

For editing (modify existing image):

1. Determine output path stem: use the session workspace path from pwd with the source filename and a timestamp (e.g. /session/workspace/abc_1712123456). If the user specifies a location, use that absolute path instead.
2. Execute:

   bash skills/image-generation/scripts/generate_image.sh edit "<prompt>" "<image_path>" "<absolute_filepath_no_ext>" [size]
   

The script appends the correct extension (.png, .jpg, .webp) based on the output image data.

• size is optional, defaults to 1024x1024. Common sizes: 1024x1024, 1024x1536, 1536x1024.
• The script reads API credentials and image model from sudoclaw.json via SUDOCLAW_CONFIG_PATH. No manual configuration needed.
• The image model is read from sudoclaw.json (set via Tools settings). If not configured, the script will report an error asking the user to set the image model in Tools settings.

The script prints the saved image file path on success, or an error message on failure.

Step 4: Show the result

Display the image inline using markdown image syntax so it renders in chat:

![<concise description>](<absolute_image_path>)

The script prints the saved file path — use that as <absolute_image_path>.