Studio image generation

Use this Skill when the user wants to generate a new image, transform a reference image, or edit selected visual content through Ekko Studio's configured image provider.

Always use the Studio media endpoint through the bundled helper. Do not call an upstream image API directly, request an API key in chat, or fall back to a different image-generation tool when Studio reports an error. The server owns provider selection and credentials.

Helper

skill_view returns this Skill's baseDirectory. Run:

node <baseDirectory>/scripts/studio-image-gen.mjs --mode text --profile <runtime-profile> --prompt <prompt> [options]

Use the exact profile shown under Runtime Context in the Ekko system prompt. The helper resolves the local Studio URL and server token without printing the token. It outputs JSON containing output_paths on success.

Before returning an image, verify the reported file exists and reference its absolute path with Markdown image syntax.

Modes

Text to image

Use when there is no reference image:

--mode text --prompt "A matte black mechanical keyboard on a clean desk" --size 1024x1024

Image to image

Use when the user wants a new composition or redraw based on a reference:

--mode image --image-path /absolute/path/reference.png --prompt "Create a refined technology brand poster"

Image edit

Use when parts of the source should be preserved:

--mode edit --image-path /absolute/path/source.png --prompt "Change the background to blue and keep the subject unchanged"

image and edit require either --image-path or --image-url. Use a local absolute path for an attached or workspace image. Do not transmit a private local image to the configured provider unless that is necessary for the user's requested edit.

Options