Learn-skills.dev image-edit

Edits an existing image using a text prompt. Use when you need to modify, enhance, or transform an image based on text instructions.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/agntswrm/agent-media/image-edit" ~/.claude/skills/neversight-learn-skills-dev-image-edit && rm -rf "$T"

manifest: data/skills-md/agntswrm/agent-media/image-edit/SKILL.md

source content

Image Edit

Edits an existing image using a text prompt (image-to-image transformation).

Command

agent-media image edit --in <path> --prompt <text> [options]

Inputs

Option	Required	Description
`--in`	Yes	Input file path or URL
`--prompt`	Yes	Text description of the desired edit
`--out`	No	Output path, filename or directory (default: ./)
`--provider`	No	Provider to use (default: auto-detect)
`--model`	No	Model override (e.g., `fal-ai/flux-2/edit` )

Output

Returns a JSON object with the edited image path:

{
  "ok": true,
  "media_type": "image",
  "action": "edit",
  "provider": "fal",
  "output_path": "edited_123_abc.png",
  "mime": "image/png",
  "bytes": 567890
}

Examples

Edit an image:

agent-media image edit --in photo.jpg --prompt "make the sky more vibrant"

Add elements to an image:

agent-media image edit --in portrait.png --prompt "add sunglasses"

Edit with specific provider:

agent-media image edit --in scene.jpg --prompt "change to night time" --provider replicate

Providers

This action requires an external provider:

fal - Requires
```
FAL_API_KEY
```
replicate - Requires
```
REPLICATE_API_TOKEN
```
runpod - Requires
```
RUNPOD_API_KEY
```
ai-gateway - Requires
```
AI_GATEWAY_API_KEY
```

The local provider does not support image editing.