Individual skill

troubleshooting

Common ComfyUI errors and fixes. OOM, missing nodes, dtype mismatches, black images, and debugging strategies

plugin/skills/troubleshooting/SKILL.md

Read pinned source

Source commit 707474d24d0d251ba04a1bebdf86620cef2eaa8b

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
No
Observed behavior
Network or broad shell
Last checked
Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
906
Repository last updated
Nov 9, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# ComfyUI Troubleshooting Guide

> Render completes but looks WRONG (artifacts, wrong subject/pose/color, a
> ControlNet/mask/LoRA not taking, a refiner degrading it)? That's not an error.
> Use the debug-render skill (`list_packs` with `action: "skill_read"`,
> `name: "debug-render"`) to localize the bad stage with run-to-node
> (`panel_run` `to_node_id`) by previewing intermediate steps. This guide is for
> runs that fail with an error, OOM, or missing node.

## Error Diagnosis Strategy

When a workflow fails, follow this approach:

1. Get the error. Use `get_history(action="diagnose")` to retrieve the execution result with the full traceback, plus any missing models/nodes
Back to top