
Comfyui Prompt Engineer
- 874 installs
- 85 repo stars
- Updated March 18, 2026
- mckruz/comfyui-expert
comfyui-prompt-engineer is a Claude Code skill that generates high-quality, model-specific text prompts for ComfyUI image and video workflows for developers who need FLUX, SDXL, SD1.5, and Wan checkpoint syntax with corr
About
comfyui-prompt-engineer is a user-invocable skill from mckruz/comfyui-expert that crafts prompts optimized for specific ComfyUI checkpoints and identity methods. It documents distinct rules for FLUX.1 dev/schnell/Kontext (natural language, CFG 3.5-4), SDXL, SD1.5, and Wan video models, including quality tags, negative prompts, and syntax conventions each architecture expects. Developers reach for comfyui-prompt-engineer when ComfyUI workflows produce flat or off-model outputs because generic prompt templates ignore checkpoint-specific behavior. The skill is OpenClaw-compatible across darwin, linux, and win32 and focuses on translating creative intent into prompts that match the target model's response profile.
- Generates optimized prompts for FLUX.1, SDXL, SD1.5 and Wan video models
- Applies correct syntax, quality tags, CFG guidance and negative prompts per model
- Provides natural language structure for FLUX (50-100 words) and quality-first tags for SDXL
- Includes ready-to-use positive and negative prompt examples for each checkpoint
- Reduces trial-and-error when crafting prompts for different ComfyUI checkpoints
Comfyui Prompt Engineer by the numbers
- 874 all-time installs (skills.sh)
- +41 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #307 of 1,335 Generative Media skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/mckruz/comfyui-expert --skill comfyui-prompt-engineerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 874 |
|---|---|
| repo stars | ★ 85 |
| Security audit | 3 / 3 scanners passed |
| Last updated | March 18, 2026 |
| Repository | mckruz/comfyui-expert ↗ |
How do you write prompts for FLUX and SDXL in ComfyUI?
Generate high-quality, model-specific text prompts for ComfyUI image and video workflows.
Who is it for?
Developers building ComfyUI image or Wan video workflows who need checkpoint-specific prompt syntax instead of generic stable-diffusion templates.
Skip if: Developers configuring ComfyUI nodes, installing models, or tuning samplers without prompt authoring should skip comfyui-prompt-engineer.
When should I use this skill?
Trigger when generating or refining ComfyUI prompts for FLUX, SDXL, SD1.5, or Wan checkpoints.
What you get
Model-specific positive prompts, negative prompts, CFG guidance, and ComfyUI-ready prompt strings
- Positive prompts
- Negative prompts
- Model-specific CFG guidance
Files
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 lensBad 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 grainSD 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 qualityAnimateDiff
- 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 qualityPuLID 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 lightingIP-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 photographyFLUX 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 compositionNegative 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, errorPhotorealism Negative
3d render, cartoon, anime, illustration, painting, drawing, cgi,
plastic skin, smooth skin, airbrushed, video game, doll, mannequin,
oversaturated, artificial lightingVideo Negative (Wan/AnimateDiff)
static, frozen, jerky motion, low quality, blurry, distorted face,
bad anatomy, glitch, artifacts, flickering, jittery, unnatural movementFLUX Negative (keep minimal)
blurry, low quality, distorted, deformed, ugly, watermark, textPrompt 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 examplesreferences/workflows.md- CFG and sampler settings per workflow- Character profiles in
projects/for trigger words and feature descriptions
Related skills
FAQ
Which ComfyUI models does comfyui-prompt-engineer support?
comfyui-prompt-engineer covers FLUX.1 dev, schnell, and Kontext, plus SDXL, SD1.5, and Wan video models. Each section documents model-specific prompt syntax, quality tags, negative prompts, and recommended CFG ranges such as 3.5-4 for FLUX.
When should developers invoke comfyui-prompt-engineer?
Developers should invoke comfyui-prompt-engineer when generating or refining prompts for ComfyUI image or video workflows. The skill tailors language style, tags, and negatives to the target checkpoint so outputs match each model's expected response profile.
Is Comfyui Prompt Engineer safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.