version: "1.0.1" name: comfyui-prompt-engineer description: Craft model-specific prompts optimized for the target checkpoint and identity method. Handles FLUX, SDXL, SD1.5, and Wan video models with proper syntax, quality tags, and negative prompts. Use when generating or refining prompts for ComfyUI workflows. user-invocable: true metadata: {"openclaw":{"emoji":"✍️","os":["darwin","linux","win32"]}}

ComfyUI Prompt Engineer

Generates optimized prompts tailored to specific models and identity methods. Different models respond differently to prompts.

Model-Specific Prompt Rules

FLUX.1 (dev/schnell/Kontext)

• Style: Natural language descriptions work best
• CFG: 3.5-4 (very low)
• Quality tags: Minimal - FLUX doesn't need "masterpiece, best quality"
• Length: Medium (50-100 words)
• Structure: {subject description}, {setting}, {lighting}, {camera/style}

Good FLUX prompt:

photorealistic portrait of a woman with auburn hair and green eyes, freckles across
her nose and cheeks, wearing a cream knit sweater, sitting in a cafe with warm ambient
lighting, shallow depth of field, shot on Sony A7IV, 85mm lens

Bad FLUX prompt (too many quality tags):

masterpiece, best quality, 8k uhd, highly detailed, photorealistic portrait...

SDXL (RealVisXL, Juggernaut, etc.)

• Style: Quality tags at front help significantly
• CFG: 7-9
• Quality tags: Include masterpiece, best quality, photorealistic
• Length: Medium-long (50-150 words)
• Structure: {quality tags}, {trigger word}, {subject}, {details}, {setting}, {style}
• Weighted syntax: Supported (important:1.3) or ((very important))

Good SDXL prompt:

masterpiece, best quality, sage_character, photorealistic portrait of a woman,
detailed skin texture with freckles, emerald green eyes, auburn copper hair,
natural lighting from window, indoor setting, shallow depth of field,
RAW photo quality, 8k uhd, film grain

SD 1.5

• Style: Tag-based works best
• CFG: 7-8
• Quality tags: Essential
• Length: Shorter (30-80 words)
• Structure: {quality}, {trigger}, {subject}, {details}, {style tags}

Wan 2.1/2.2 (Video)

• Style: Concise motion descriptions
• CFG: 5-7
• Quality tags: Minimal
• Length: Short (20-50 words)
• Focus: Describe the motion, not just the appearance
• Structure: {subject}, {action/motion}, {setting}, {quality}

Good Wan prompt:

young woman with auburn hair, talking naturally with gentle hand gestures,
seated at a modern desk, soft studio lighting, high quality

AnimateDiff

• Style: Same as base model (SD1.5/SDXL) but add motion keywords
• Motion keywords: Include camera/subject motion description
• Length: Same as base model

With Identity Methods

InstantID Prompts

Key adjustments:

• DO NOT describe specific facial features (the model provides them)
• DO describe everything else: clothing, pose, setting, lighting
• Keep CFG at 4-5

photorealistic portrait, wearing black leather jacket, standing in an alley,
dramatic side lighting, urban setting, moody atmosphere, 8k quality

PuLID Prompts

Key adjustments:

• Can include some facial descriptions (PuLID is more tolerant)
• Method "neutral" for realistic, "fidelity" for exact match
• CFG 5-7

sage_character, photorealistic portrait, green eyes visible, natural makeup,
professional headshot, neutral grey background, studio lighting

IP-Adapter FaceID

Key adjustments:

• Describe the style you want, not the face
• weight_type "style transfer" for 3D→realistic
• Standard CFG for base model

photorealistic portrait, DSLR photo quality, natural skin texture,
warm indoor lighting, bokeh background, professional photography

FLUX Kontext (Editing)

Key adjustments:

• Describe the EDIT, not the full image
• Be specific about what to change
• Mention what to preserve

Change the outfit to a formal black evening dress while keeping the face,
hair, and pose exactly the same. Add subtle jewelry.

With Character LoRA

Key adjustments:

• ALWAYS include trigger word first
• Don't describe features the LoRA has learned
• Focus on what varies: pose, clothing, setting, lighting

sage_character, standing on a rooftop at sunset, wind blowing hair,
wearing casual summer dress, city skyline behind, golden hour lighting,
cinematic composition

Negative Prompt Templates

Universal Negative (SDXL/SD1.5)

(worst quality:1.4), (low quality:1.4), blurry, deformed, bad anatomy,
bad hands, extra fingers, missing fingers, extra limbs, fused fingers,
text, watermark, signature, jpeg artifacts, username, error

Photorealism Negative

3d render, cartoon, anime, illustration, painting, drawing, cgi,
plastic skin, smooth skin, airbrushed, video game, doll, mannequin,
oversaturated, artificial lighting

Video Negative (Wan/AnimateDiff)

static, frozen, jerky motion, low quality, blurry, distorted face,
bad anatomy, glitch, artifacts, flickering, jittery, unnatural movement

FLUX Negative (keep minimal)

blurry, low quality, distorted, deformed, ugly, watermark, text

Prompt Construction Workflow

1. Get character profile from projects/{project}/characters/{name}/profile.yaml
2. Get target model from inventory/user preference
3. Apply model rules from above
4. Add identity method modifiers if applicable
5. Include trigger word if LoRA is being used
6. Draft positive + negative pair
7. Review against past successes in character's generation_history
8. Adjust CFG recommendation based on method stack

Reference

• references/prompt-templates.md - Full template library with examples
• references/workflows.md - CFG and sampler settings per workflow
• Character profiles in projects/ for trigger words and feature descriptions