comfyui-prompt-engineer

mckruz/comfyui-expert · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/mckruz/comfyui-expert --skill comfyui-prompt-engineer
0 commentsdiscussion
summary

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

skill.md

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
how to use comfyui-prompt-engineer

How to use comfyui-prompt-engineer on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add comfyui-prompt-engineer
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/mckruz/comfyui-expert --skill comfyui-prompt-engineer

The skills CLI fetches comfyui-prompt-engineer from GitHub repository mckruz/comfyui-expert and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/comfyui-prompt-engineer

Reload or restart Cursor to activate comfyui-prompt-engineer. Access the skill through slash commands (e.g., /comfyui-prompt-engineer) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.456 reviews
  • Sakura Liu· Dec 28, 2024

    Registry listing for comfyui-prompt-engineer matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Sophia Harris· Dec 20, 2024

    comfyui-prompt-engineer reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Pratham Ware· Dec 12, 2024

    Useful defaults in comfyui-prompt-engineer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Sophia Taylor· Dec 12, 2024

    I recommend comfyui-prompt-engineer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Li Patel· Dec 4, 2024

    We added comfyui-prompt-engineer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Michael Ghosh· Dec 4, 2024

    Keeps context tight: comfyui-prompt-engineer is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Mei Gupta· Nov 23, 2024

    Keeps context tight: comfyui-prompt-engineer is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Hiroshi Wang· Nov 23, 2024

    We added comfyui-prompt-engineer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Mei Iyer· Nov 7, 2024

    comfyui-prompt-engineer reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Sakshi Patil· Nov 3, 2024

    comfyui-prompt-engineer has been reliable in day-to-day use. Documentation quality is above average for community skills.

showing 1-10 of 56

1 / 6