comfyui-node-basics

Automate V3 ComfyUI node creation and registration with io.Schema and ComfyExtension.

265|28|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comfyui-node-basics
Source: https://github.com/jtydhr88/comfyui-custom-node-skills/tree/main/plugins/comfyui-custom-nodes/skills/comfyui-node-basics
Command: npx skills add https://github.com/jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ComfyUI node development can be verbose and error-prone without a clear structure. This Skill guides you through building V3 nodes using io.ComfyNode, defining schemas, and registering extensions for discovery and UI integration.

Core Features & Use Cases

  • Define a V3 node with a well-typed input/output schema using io.Schema
  • Implement an execute method to perform computation and return NodeOutput
  • Register nodes via a ComfyExtension to expose them in Claude UI or UI menus

Quick Start

Define a V3 node schema and a corresponding execute method, then register the node via a ComfyExtension.

Frequently Asked Questions about comfyui-node-basics

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

FAQPage Schema
How do I create and register a V3 ComfyUI node using Python?

To create and register a V3 ComfyUI node, define a well-typed input and output schema using the io.Schema API, implement an execute method returning NodeOutput, and register the node via a ComfyExtension for UI integration.

What is the io.Schema API used for in ComfyUI node development?

The io.Schema API is used in ComfyUI node development to define well-typed input and output schemas for V3 nodes, ensuring a clear structure that prevents errors when specifying the data flow between custom nodes.

How do I expose a custom ComfyUI node in the UI menu?

You expose a custom ComfyUI node in the UI menu by registering it through a ComfyExtension, which ensures the node has a unique ID and is properly discovered for UI integration.

Do I need Python knowledge to build V3 ComfyUI nodes?

Yes, you need Python knowledge to build V3 ComfyUI nodes because the development process requires implementing the execute method and using the io.Schema API to define the node's computation and data structures.

What's the best way to structure inputs and outputs for a ComfyUI extension?

The best way to structure inputs and outputs for a ComfyUI extension is using the io.Schema API to define well-typed schemas, which clearly map data for the execute method to process and return as NodeOutput.

Why does my custom ComfyUI node not show up in the UI?

A custom ComfyUI node may not show up in the UI if it is not properly registered via a ComfyExtension or lacks a unique node ID, which are required for successful discovery and UI integration.