# Image Gen

Generate or edit images through Ekko Studio using the current Profile's configured...

- Repository: https://github.com/EKKOLearnAI/ekko-studio (11634 stars)
- Category: Media
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add EKKOLearnAI/ekko-studio --skill image-gen -g -a claude-code -y`
Codex: `npx skills add EKKOLearnAI/ekko-studio --skill image-gen -g -a codex -y`
Cursor: `npx skills add EKKOLearnAI/ekko-studio --skill image-gen -g -a cursor -y`
Gemini CLI: `npx skills add EKKOLearnAI/ekko-studio --skill image-gen -g -a gemini-cli -y`

## Description

Generate or edit images through Ekko Studio using the current Profile's configured image provider.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

```text
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:

```text
--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:

```text
--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:

```text
--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

The rest: https://github.com/EKKOLearnAI/ekko-studio/blob/HEAD/packages/ekko-agent/skills/image-gen/SKILL.md