comfyui-node-outputs

Document ComfyUI NodeOutput variants and preview or saved artifact integration.

Updated May 29, 2026
One-click install
npx skills add https://github.com/TurkeyC/Dotfiles --skill comfyui-node-outputs-turkeyc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comfyui-node-outputs
Source: https://github.com/TurkeyC/Dotfiles/tree/main/private_dot_copilot/skills/comfyui-custom-node-skills/skills/comfyui-node-outputs
Command: npx skills add https://github.com/TurkeyC/Dotfiles --skill comfyui-node-outputs-turkeyc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ComfyUI developers and node authors often need a consistent and documented way to declare, return, and showcase data and UI outputs from nodes. This Skill provides a structured pattern for NodeOutput usage and preview/saved artifact integration.

Core Features & Use Cases

  • Define and document NodeOutput variants (data-only, UI-only, and data+UI) and their usage in node schemas.
  • Guide how to wire outputs to previews (PreviewImage, PreviewMask, PreviewText, etc.) and how to save results (SavedImages, SavedAudio, etc.).
  • Illustrate integration with saving helpers and SavedResult objects to produce UI assets in the output or temp folders.

Quick Start

Create a node that returns a UI preview along with a data tensor using the NodeOutput framework.

Frequently Asked Questions about comfyui-node-outputs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define ComfyUI node outputs for UI previews and saved files?

To define ComfyUI node outputs, use the NodeOutput framework to standardize schemas for data tensors and UI assets. This ensures nodes correctly return PreviewImage or SavedImages objects for display in the interface.

What is the NodeOutput pattern in ComfyUI node authoring?

The NodeOutput pattern is a structured framework for declaring data-only, UI-only, or data+UI returns from ComfyUI nodes. It standardizes how outputs wire to previews and saving helpers to generate artifacts.

How do I wire a ComfyUI node to PreviewImage and SavedImages outputs?

You wire ComfyUI nodes to outputs by integrating saving helpers and SavedResult objects. This guides data tensors and UI assets into PreviewImage or SavedImages nodes to populate the output or temp folders.

Can I return both data tensors and UI previews from a single ComfyUI node?

Yes, you can return both data and UI outputs from a single ComfyUI node using the data+UI NodeOutput variant. This allows the node schema to declare simultaneous data tensors and UI preview assets.

Does this NodeOutput framework require specific dependencies for ComfyUI workflows?

No, the NodeOutput framework for ComfyUI workflows requires no external dependencies. It provides a structured pattern using YAML frontmatter and standard saving helpers to document and manage node artifacts.

Why are my ComfyUI node UI previews not saving to the output folder?

ComfyUI UI previews fail to save when outputs are not properly wired to saving helpers and SavedResult objects. Using the NodeOutput framework ensures artifacts route correctly to the output or temp folders.