qwen-edit

SKILL.md

Qwen-Image-Edit Skill

AI-powered image editing using Qwen-Image-Edit-2511 via RunPod serverless.

Status: Evolving - learnings being captured as we experiment

When to Use This Skill

Use when the user wants to:

Edit/transform photos while preserving identity

Reframe cropped images (fix cut-off heads, etc.)

Change clothing, add accessories

Change pose (arm positions, hand placement)

Apply style transfers (cyberpunk, anime, oil painting)

Adjust lighting/color grading

Add/remove objects

Character transformations (Bond, Neo, etc.)

When NOT to Use

Background replacement (single image) - creates cut-out artifacts, halos

Face swapping - cannot preserve identity from reference

Outpainting - can't extend canvas reliably

Use With Care

Multi-image compositing - CAN work with explicit identity anchors (see examples.md for prompt patterns). Requires describing distinctive features (hair texture/color, ethnicity, outfit) and using guidance ~2.0

Camera angle changes - Inconsistent results. Vertical angles (low/high) work better than rotational (three-quarter view)

Quick Reference

# Basic edit
python tools/image_edit.py --input photo.jpg --prompt "Add sunglasses"

# With negative prompt (recommended)
python tools/image_edit.py --input photo.jpg \
  --prompt "Reframe as portrait with full head visible" \
  --negative "blur, distortion, artifacts"

# Style transfer
python tools/image_edit.py --input photo.jpg --style cyberpunk

# Background (use cautiously - often fails)
python tools/image_edit.py --input photo.jpg --background office

# Higher quality
python tools/image_edit.py --input photo.jpg --prompt "..." --steps 16 --guidance 3.0

# Multi-image composite (identity-preserving)
python tools/image_edit.py --input person.jpg background.jpg \
  --prompt "The [ethnicity] [gender] with [hair description] from first image is now in [scene] from second image. Same [features], [outfit]." \
  --negative "different ethnicity, different hair color, different face shape, generic stock photo" \
  --steps 16 --guidance 2.0

Key Files

prompting.md - Prompt patterns and structure

examples.md - Good/bad examples from experiments

parameters.md - Tuning steps, guidance, negative prompts

Tool Location

tools/image_edit.py - CLI wrapper for RunPod endpoint

Related Docs

docs/qwen-edit-patterns.md - Character transformation patterns

.ai_dev/qwen-edit-research.md - Research notes