Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
mckruz avatar

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-engineer

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs874
repo stars85
Security audit3 / 3 scanners passed
Last updatedMarch 18, 2026
Repositorymckruz/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

SKILL.mdMarkdownGitHub ↗

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

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.

Generative Mediallmautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.