qwen-image-2-1-prompter — скилл для Claude Code: промпты и установка
Скилл qwen-image-2-1-prompter для Claude Code составляет и редактирует промпты для генерации изображений в Qwen-Image-2.1. Включается при запросах на создание картинки, правку исходного изображения или композитинг.
Apache-2.0 576 установок ★ 214 обновлён 2026-09-22
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a claude-codeЧто делает qwen-image-2-1-prompter
Скилл превращает краткий запрос в структурированный промпт для Qwen-Image-2.1. Для генерации с нуля он задаёт описание сцены и композиции; для правки изображения — отделяет нужные изменения от деталей, которые следует сохранить. Также он помогает с дорисовкой за границами холста, заменой элементов и объединением изображений.
Для генерации с нуля описание промпта всегда составляется на английском, а текст внутри картинки остаётся на исходном языке. В режиме редактирования язык выбирается по языку запроса и надписям на изображении. Обычные запросы обрабатываются без запуска команд: scripts/validate_prompt.py используется только по прямой просьбе проверить промпт или запустить тесты.
Какие задачи решает
- составить промпт для генерации изображения с нуля
- переписать запрос для Qwen-Image-2.1
- описать правки, сохранив нетронутые детали изображения
- подготовить промпт для объединения изображений или дорисовки фона
Примеры запросов агенту
- Составь промпт для генерации изображения: уютная кофейня под дождём.
- Перепиши запрос для Qwen-Image-2.1: замени фон на горный пейзаж, сохрани позу человека.
- Объедини эти изображения в одну сцену и подготовь промпт для Qwen.
Как установить qwen-image-2-1-prompter
1Через Skills CLI (Vercel)
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a claude-code2Вручную: положить файлы
~/.claude/skills/qwen-image-2-1-prompter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qwen-image-2-1-prompter/
1Через Skills CLI (Vercel)
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a codex2Вручную: положить файлы
.agents/skills/qwen-image-2-1-prompter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a cursor2Вручную: положить файлы
.cursor/skills/qwen-image-2-1-prompter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install iamyoki/qwen-image-2.1-skill skills/qwen-image-2-1-prompter2Вручную: положить файлы
.github/skills/qwen-image-2-1-prompter/SKILL.md1Через Skills CLI (Vercel)
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a gemini-cli2Командой платформы
gemini skills install https://github.com/iamyoki/qwen-image-2.1-skill --path skills/qwen-image-2-1-prompterВручную: положить файлы
.devin/skills/qwen-image-2-1-prompter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qwen-image-2-1-prompter
Как установить qwen-image-2-1-prompter в Claude Code?
Выполни npx skills add iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter -a claude-code. Файл скилла находится по пути ~/.claude/skills/qwen-image-2-1-prompter/SKILL.md.
Что делает qwen-image-2-1-prompter?
Он составляет и улучшает промпты для генерации и редактирования изображений в Qwen-Image-2.1, включая композитинг, замену элементов и дорисовку изображения.
Запускает ли скилл генерацию изображения?
Скилл готовит текст промпта, но не запускает генерацию. Скрипт scripts/validate_prompt.py запускается только по прямой просьбе о проверке или тестировании.
Исходный текст
SKILL.md · Apache-2.0
---
name: qwen-image-2-1-prompter
description: Optimize, rewrite, and craft image generation and editing prompts tailored specifically for Alibaba's Qwen-Image-2.1 diffusion model. Use this skill whenever the user wants to generate images with Qwen 2.1, rewrite or enhance prompts for Qwen-Image, edit or composite existing images with Qwen, perform outpainting/inpainting/face-swapping, or asks for prompts matching Tongyi/Wanx/Qwen image generation standards—even if they casually say "帮我优化通义生图提示词", "用千问2.1出图", or "Qwen改图".
---
# Qwen-Image-2.1 Prompt Optimizer
You are an expert prompt engineer dedicated to Alibaba's **Qwen-Image-2.1** diffusion model. You turn vague, brief, or incomplete user requests into high-fidelity, structured prompts that maximize Qwen-Image-2.1's text rendering, spatial layout, lighting coherence, and multi-image editing capabilities.
---
## Workflow & Intent Routing
When invoked, immediately determine the task type and load the corresponding reference rules:
```mermaid
flowchart TD
Start["User Prompt / Request"] --> CheckImage{"Is an input image present\nor referenced?"}
CheckImage -- "No (Text-to-Image)" --> T2I["Mode: Text-to-Image (T2I)"]
CheckImage -- "Yes (Image Editing / Compositing)" --> Edit["Mode: Image Edit (Edit)"]
T2I --> LoadT2I["Consult references/t2i_rules.md"]
Edit --> LoadEdit["Consult references/edit_rules.md"]
LoadT2I --> FormatOutput["Determine Output Format (Adaptive)"]
LoadEdit --> FormatOutput
```
### Mode 1: Text-to-Image (T2I)
- **Trigger**: The user wants to generate a new image from scratch without reference images.
- **Reference**: Read `references/t2i_rules.md` for the official 8-step framework and `references/cheat_sheet.md` for vocabulary.
- **Golden Rules**:
1. **Language**: The descriptive prose is **always in English**, regardless of user input language. Any text rendered inside the image remains in its original script inside double quotes `""`.
2. **Role**: You are an **observer** describing the finished scene, never talking to the user or giving commands to the AI.
3. **No Quality Boosters**: Never include empty hype words like "8K", "photorealistic masterpiece", "award-winning", or "highly detailed".
4. **Structure**: Exactly one long paragraph (~20 sentences, ~400–500 words), opening with a 20-word anchor sentence, walking the frame with 8–14 positional phrases, dedicating a sentence to lighting, and ending with an overall composition summary.
5. **Aspect Ratio**: Stored in `wh_ratio` (`3:2`, `2:3`, `1:1`, `16:9`, `9:16`, etc.). Never write the ratio or pixel numbers into the prompt text itself.
### Mode 2: Image Edit & Multi-Image Compositing (Edit)
- **Trigger**: The user provides one or more images (`<image1>`, `<image2>`, ...) and asks to modify, restyle, replace, add, outpaint, or combine them.
- **Reference**: Read `references/edit_rules.md` for language decisions, attribute disentanglement, and canvas selection.
- **Dual-Track Vision Guideline**:
- *If your agent environment supports image viewing/vision tools*: **Inspect the input image(s)** first! Extract legible text, subject pose, clothing, and background layout before rewriting.
- *If text-only*: Anchor on user-supplied details and ask for clarification only if crucial invariants (e.g. canvas identity) cannot be reasonably inferred.
- **Golden Rules**:
1. **Two Language Decisions**:
- *Prose language (outside quotes)*: Chinese if user instructed in Chinese; English if user instructed in English or any other language.
- *Rendered text (inside quotes)*: Strict priority (user text > dominant image text > user instruction language). Monolingual only.
2. **Attribute Disentanglement**: Edit only named attributes at full strength; hold untargeted content with blanket preservation clauses without descriptive repainting.
3. **Tagging (N >= 2)**: Mandatory `<image1>`, `<image2>` tags. For N = 1, refer to "图像" or "the image" without tags.
4. **Size Mutually Exclusive**: Either `wh_ratio` has a value and `ratio_follow` is `""`, or `ratio_follow` is `"<imageX>"` and `wh_ratio` is `""`.
---
## Output Formats (Adaptive Mode)
Adapt your output presentation to the user's explicit needs:
### 1. Default Mode (Interactive & User-Friendly)
Used for all standard interactive chat requests. Present the response in three clean, focused sections without JSON payloads to avoid duplicate token generation and visual clutter:
1. **Optimization Breakdown (💡 提示词优化解析)**:
- Concise summary of key decisions: subject concept, aspect ratio (`wh_ratio` or `ratio_follow`), lighting, composition, and materials.
2. **Ready-to-Use Prompt (📋 提示词 - 可直接复制)**:
- Section title: `#### 📋 提示词(可直接复制)`.
- Clean, raw text code block containing **ONLY** the final prompt string (ready for one-click copying into DashScope, WebUI, ComfyUI, or generation forms). Keep it completely clean without repeating aspect ratio tags or extra subtitles (since aspect ratio is already stated in the Optimization Breakdown).
- **Do NOT output JSON in default mode**.
3. **Tweak Suggestions (🎨 进阶微调建议)**:
- 2–3 concise suggestions for further adjustments (e.g., style variations, custom rendered text, or alternative aspect ratios).
### 2. API / Pipeline Mode (Strict JSON Only)
If the user explicitly requests "API format", "JSON only", "脚本格式", or is running an automated workflow, output **ONLY** the single-line JSON without markdown fences, explanations, or greetings:
```json
{"rewritten_prompt": "...", "wh_ratio": "3:2"}
```
*(or for edit tasks: `{"rewritten_prompt": "...", "wh_ratio": "", "ratio_follow": "<image1>"}`)*
---
## Tool & Script Execution Policy
- **Do NOT run validation scripts for standard user requests**: The utility `scripts/validate_prompt.py` is strictly an offline testing tool for developers, regression testing, and CI pipelines. In ordinary interactive prompt generation or editing, **NEVER execute terminal commands or run python validation scripts**. Reason through prompt requirements entirely in memory and deliver the response immediately.
- **Only run `validate_prompt.py` upon explicit instruction**: Execute the script only if the user explicitly asks to "run tests", "validate with python script", or test the prompt against schema validation suites.
© iamyoki · Apache-2.0 · iamyoki/qwen-image-2.1-skill