debug-render Skill
✓ VerifiziertDebugge unperfekte Renders, indem du run-to-node Execution nutzt, um intermediate Latents, Masks und Preprocessor Maps zu inspizieren.
- GitHub Stars
- 919
- Dateien
- 1
- Letzter Commit
- 9. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der debug-render Skill?
Debugge unperfekte Renders, indem du run-to-node Execution nutzt, um intermediate Latents, Masks und Preprocessor Maps zu inspizieren.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den debug-render skill
Die Hauptfunktion dieses Skills besteht darin, herauszufinden, warum ein generiertes Bild oder Video fehlerhaft aussieht, ohne einen kompletten, komplexen Graph neu ausführen zu müssen. Er wurde für Developer und Artists entwickelt, die ComfyUI nutzen und auf unperfekte Ergebnisse wie Artefakte, falsche Farben oder fehlerhafte ControlNet-Anwendungen stoßen. Anstatt zu raten, nutzt du run-to-node Execution, um spezifische Phasen einer Pipeline zu isolieren und genau zu sehen, an welcher Stelle ein visueller Fehler auftritt.
User verwenden den panel_run Command mit dem to_node_id Parameter, um partielle Ausführungen zu triggern. Dieser Ansatz rendert nur den notwendigen Upstream-Pfad zu einem spezifischen Output Node, was Probes schnell und effizient macht. Falls ein Zielpunkt noch kein Output Node ist, kannst du panel_add_node und panel_connect nutzen, um Preview Taps wie PreviewImage, VAEDecode oder MaskToImage einzufügen. Dies ermöglicht die Inspektion von intermediate Latents, Masks und Preprocessor Maps. Sobald der Fehler lokalisiert ist, kannst du Fixes mittels panel_set_widget oder panel_set_node_mode anwenden, bevor du ein finales Full Render durchführst.
Was ein agent damit machen kann
- 1Fehlerhafte ControlNet-Inputs isolierenPrüfe, ob ein Preprocessor die korrekte Depth- oder Pose-Map generiert, bevor sie den Sampler erreicht.
- 2Mask-Misalignment beim Inpainting debuggenVerifiziere, ob die für Inpainting oder Outpainting verwendete Mask korrekt positioniert und geformt ist.
- 3Qualitätsverlust in Upscaling-Phasen identifizierenFinde heraus, ob ein Refiner oder ein Upscale-Schritt die Ursache für den Qualitätsverlust ist, indem du das Base Lat inspizierst.
- 4IPAdapter Reference Images verifizierenInspiziere das prozessierte Reference Image, um sicherzustellen, dass es für den Adapter korrekt resized oder gecroppt wird.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den debug-render Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den debug-render Skill in Plugin installieren
/plugin marketplace add artokun/comfyui-mcp /plugin install comfy@comfyui-mcp
Den debug-render Skill in Claude Code installieren
~/.claude/skills/debug-render/SKILL.md
$ npx degit artokun/comfyui-mcp/plugin/skills/debug-render ~/.claude/skills/debug-renderDen debug-render Skill in Claude Code (project) installieren
.claude/skills/debug-render/SKILL.md
$ npx degit artokun/comfyui-mcp/plugin/skills/debug-render .claude/skills/debug-renderDen debug-render Skill in Codex installieren
~/.agents/skills/debug-render/SKILL.md
$ npx degit artokun/comfyui-mcp/plugin/skills/debug-render ~/.agents/skills/debug-renderDen debug-render Skill in Gemini CLI installieren
~/.gemini/skills/debug-render/SKILL.md
$ npx degit artokun/comfyui-mcp/plugin/skills/debug-render ~/.gemini/skills/debug-renderDen debug-render Skill in Claude.ai installieren
npx degit artokun/comfyui-mcp/plugin/skills/debug-render debug-render && zip -r debug-render.zip debug-render # claude.ai → Customize → Skills → + → Create skill → Upload a skill → debug-render.zip
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarartokun/comfyui-mcp/plugin/skills/debug-render is public and reachablegithub.com/artokun/comfyui-mcp/tree/HEAD/plugin/skills/debug ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-09github.com/artokun/comfyui-mcp/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/artokun/comfyui-mcp/blob/HEAD/plugin/skills/debug ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/artokun/comfyui-mcp/blob/HEAD/plugin/skills/debug ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 111 linesgithub.com/artokun/comfyui-mcp/blob/HEAD/plugin/skills/debug ↗Bestanden
SKILL.md
Auf GitHub ansehenDebugging renders with run-to-node
When a final asset looks wrong (not when it errors), don't re-roll the whole graph and hope. Localize the fault. Render only as far as one stage and look at what that stage actually produces. The wrong-looking output is downstream of a first bad step. Find that step, fix it there, and everything after it follows.
The tool for this is panel_run with to_node_id ("run to node"), which uses
ComfyUI's native partial execution. Only the target output node plus
everything upstream of it renders; every other branch is skipped. That makes each
probe fast and cheap, and the output is delivered to you automatically, same
as any run. Don't poll.
When to reach for this
- A final image/video is wrong: artifacts, wrong subject/pose/composition, off color, soft/blurry, melted hands, wrong style.
- A conditioner isn't "taking" (ControlNet, IPAdapter, a mask, an inpaint, a LoRA) and you can't tell if the input to it is wrong or the node is wrong.
- A multi-stage pipeline (base → refiner, txt2img → upscale, decode → post) degrades, and you need to see which stage introduces the problem.
- You only want to test one branch of a multi-output graph without paying for the others.
If instead the run fails (red error, OOM, missing node, black image from a crash), use the troubleshooting skill. This skill is for outputs that complete but look wrong.
The one hard rule: to_node_id must be an OUTPUT node
ComfyUI can only run to an output node: SaveImage, PreviewImage, SaveVideo,
SaveAudio, etc. (these show is_output: true in panel_query_graph detail rows). A bare
KSampler / VAEDecode / preprocessor is not an output node, so you can't target
it directly. To inspect a point that isn't already an output, add a preview
tap there:
| You want to see… | Wire type | Tap to add | Wiring |
|---|---|---|---|
| An intermediate image (post-process, refiner stage, composite) | IMAGE | PreviewImage |
image → PreviewImage.images |
| A latent (after a sampler, before/after upscale) | LATENT | VAEDecode → PreviewImage |
latent → VAEDecode.samples; reuse the graph's VAE → VAEDecode.vae; then → PreviewImage |
| A mask (inpaint, segmentation, attention) | MASK | MaskToImage → PreviewImage |
mask → MaskToImage.mask → PreviewImage |
| A ControlNet/preprocessor map (depth/pose/canny) | usually IMAGE already | PreviewImage |
the preprocessor's IMAGE output → PreviewImage.images |
| The actual prompt/conditioning | CONDITIONING | (can't preview as an image) | inspect widget values / the text node feeding it instead |
Build a tap with panel_add_node + panel_connect, run to it, inspect, then
panel_remove_node the tap when you're done (unless the user wants to keep it).
The loop
- Read the graph.
panel_graph_outline(thenpanel_query_graphfor specifics). Note node ids, the output nodes (is_output: true), and every node's mode. A node inbypass/muteon the path is OFF and is a top cause of wrong renders. Fix modes first withpanel_set_node_modebefore you blame anything else. - Pick a probe point roughly in the middle of the suspect chain (bisect).
- Get an output there. Target an existing output node, or add a preview tap (table above).
panel_run(to_node_id = that output node). Only that branch renders.- Look at what's delivered. Is this stage already wrong, or still fine?
- Still fine: move the probe downstream; the fault is later.
- Already wrong: move the probe upstream; the fault is earlier.
- Repeat until you find the first stage whose output is bad. That node (or
its inputs/widgets) is what to fix, via
panel_set_widget,panel_set_node_mode, a rewire, or a different model. Then run-to-node there again to confirm the fix before running the full graph. - Clean up temporary preview taps (
panel_remove_node) and do a final fullpanel_runto produce the real saved asset.
Symptom → where to probe first
- Whole image wrong subject/style. Preview the conditioning's source (the text/prompt node, the sampler's positive input via a decode of its latent).
- ControlNet ignored / wrong structure. Preview the preprocessor map (the depth/pose/canny IMAGE going into the ControlNet). A blank or wrong map means the problem is the preprocessor or its input, not the sampler.
- IPAdapter/reference not taking. Preview the reference image after any resize/crop the IPAdapter chain applies.
- Inpaint/outpaint bleeding.
MaskToImage-preview the mask actually reaching the sampler (mask misalignment is the usual culprit). - Refiner/upscale degrades it. Preview the base latent (VAEDecode tap) before the refiner vs after. If the base is good and the result is bad, the refiner/upscale stage is at fault.
- Right content, bad quality only. The fault is late (sampler steps/cfg, VAE, post), so probe near the end first.
Gotchas
- Output-node only. If you target a non-output node, the run is rejected with a message saying so. Add a preview tap instead.
- Modes matter. A bypassed/muted node on the probed path silently changes what renders. Check modes in step 1.
- Auto-delivery. The probe's output node fires an
executedevent and the image is delivered to you inline, including PreviewImage taps, which arrive labeled as a preview (temporary, not a saved file). Don't poll; just end the turn and read the delivered image. A preview tap with no SaveImage means "no saved output ran", which is expected for a probe. - Shared queue. Each run-to-node queues a real (small) job. Don't stack probes. Run one, read it, then the next.
- Subgraphs. Output nodes nested inside a subgraph can't be targeted yet. Probe at the root graph (add the tap outside the subgraph, fed by an exposed output rail).
Sources
- Official: comfyui-mcp
panel_runto_node_id product behavior (this repo). - Empirical: probe-point recipes from observed wrong-render cases.
Dateien in diesem Skill
1debug-render Skill-Fragen
Wie installiere ich den debug-render Skill in Claude Code?
Führe npx degit artokun/comfyui-mcp/plugin/skills/debug-render ~/.claude/skills/debug-render aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den debug-render Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Was soll ich tun, wenn das Rendering mit einem Fehler oder OOM abbricht?
Wenn der Run aufgrund eines roten Fehlers, Out of Memory (OOM) oder fehlender Nodes fehlschlägt, solltest du anstelle dieses Skills das Troubleshooting Skill verwenden.
Kann ich ein Rendering direkt an einen KSampler Node ausführen?
Nein, du kannst nur Output Nodes wie SaveImage oder PreviewImage anvisieren. Um einen Non-Output Node zu inspizieren, musst du zuerst einen Preview Tap hinzufügen.
Wie inspiziere ich eine Mask während des Rendering-Prozesses?
Um eine Mask zu sehen, füge einen MaskToImage Node hinzu, der mit einem PreviewImage Node verbunden ist, und verbinde die Mask dann mit dem MaskToImage Input.