qwen-edit

name	qwen-edit
description	AI image editing prompting patterns for Qwen-Image-Edit. Use when editing photos while preserving identity, reframing cropped images, changing clothing or accessories, adjusting poses, applying style transfers, or character transformations. Provides prompt patterns, parameter tuning, and examples.

This skill was copied from the claude-code-video-toolkit seed (commit b86feda) on 2026-05-18.

Workspace adaptations:

• References to the seed's tools/*.py scripts (e.g., tools/voiceover.py, tools/image_edit.py, tools/sadtalker.py) do not exist in this workspace. Image/video/voice generation here is orchestrated by TypeScript in lib/ (lib/audio.ts, lib/assets.ts, lib/render.ts) calling Modal jobs (for FLUX images) and the Higgsfield CLI (for video clips).
• Treat any seed-tool path as a conceptual reference; the actual command in this workspace is the corresponding lib/*.ts function or a direct higgsfield/modal CLI call.
• Briefs live in briefs/<slug>.md, per-render workspaces in runs/<slug>/, finished MP4s in videos/.

Qwen-Image-Edit Skill

AI-powered image editing using Qwen-Image-Edit-2511. In this workspace, hosted on Modal (not RunPod as the seed used). The prompting patterns below are model-specific and remain accurate; only the invocation differs (modal run modal_jobs/qwen_edit.py ... instead of tools/image_edit.py).

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