К основному содержанию
скилл CX Codex

comfyui-node-basics — скилл для Claude Code: создание узлов

Скилл comfyui-node-basics помогает описать структуру пользовательского узла ComfyUI на V3 API, задать его схему и подключить регистрацию. Пригодится при создании узла с нуля или настройке проекта.

MIT ★ 321 обновлён 2026-10-17

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add jtydhr88/comfyui-custom-node-skills
/plugin install comfyui-custom-nodes@comfyui-custom-node-skills
Открыть на GitHub

Что делает comfyui-node-basics

Скилл разбирает устройство узла V3: класс наследуется от io.ComfyNode, define_schema() задаёт идентификатор, категорию, входы и выходы, а execute() выполняет вычисление. Результат возвращается через io.NodeOutput. Параметры execute() должны совпадать с ID входов, а число значений результата — с числом выходов.

Регистрация устроена через ComfyExtension и функцию comfy_entrypoint() на уровне модуля. В материале также описан подход V1 с NODE_CLASS_MAPPINGS и сравнены его отличия от V3. В V3 методы работают как classmethod, поэтому состояние экземпляра узла использовать нельзя.

Скилл подходит для Claude Code и Codex. Он описывает структуру кода, а не создаёт узел автоматически: схему, вычисление и регистрацию нужно реализовать в проекте.

Какие задачи решает

  • описать входы и выходы пользовательского узла ComfyUI
  • связать параметры схемы с аргументами execute()
  • зарегистрировать V3-узел через ComfyExtension
  • сопоставить старую структуру V1 с API V3

Примеры запросов агенту

  • Создай пользовательский узел ComfyUI на V3 API с входом изображения и выходом изображения.
  • Проверь, совпадают ли ID входов схемы с параметрами execute() в моём узле.
  • Покажи, как зарегистрировать класс узла через ComfyExtension и comfy_entrypoint().

Как установить comfyui-node-basics

1Через маркетплейс плагинов

/plugin marketplace add jtydhr88/comfyui-custom-node-skills
/plugin install comfyui-custom-nodes@comfyui-custom-node-skills

Команда ставит плагин comfyui-custom-nodes целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics -a claude-code

3Вручную: положить файлы

~/.claude/skills/comfyui-node-basics/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/comfyui-node-basics/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о comfyui-node-basics

Как установить comfyui-node-basics в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add jtydhr88/comfyui-custom-node-skills, затем установите плагин командой /plugin install comfyui-custom-nodes@comfyui-custom-node-skills.

Что делает comfyui-node-basics?

Скилл объясняет, как задавать схему и логику узла ComfyUI через V3 API, а также регистрировать его. В нём есть сравнение с устаревшей структурой V1.

Чем V3 отличается от V1 в ComfyUI?

В V3 узел наследуется от io.ComfyNode, схема описывается через io.Schema, а регистрация выполняется через ComfyExtension и comfy_entrypoint(). В V1 используются обычный класс, INPUT_TYPES() и NODE_CLASS_MAPPINGS.

Исходный текст

SKILL.md · MIT
---
name: comfyui-node-basics
description: ComfyUI custom node fundamentals - V3 node structure, Schema, inputs/outputs, registration. Use when creating new ComfyUI custom nodes, defining node classes, or setting up a custom node project.
---

# ComfyUI Custom Node Basics (V3 API)

ComfyUI uses Python classes to define nodes. The **V3 API** is the current recommended approach. Nodes inherit from `io.ComfyNode` and define a schema + execute method.

## Quick Start

```python
from comfy_api.latest import ComfyExtension, io

class MyNode(io.ComfyNode):
    @classmethod
    def define_schema(cls):
        return io.Schema(
            node_id="MyNode",
            display_name="My Custom Node",
            category="my_category",
            inputs=[
                io.Image.Input("image"),
                io.Float.Input("strength", default=1.0, min=0.0, max=1.0, step=0.01),
            ],
            outputs=[
                io.Image.Output("IMAGE"),
            ],
        )

    @classmethod
    def execute(cls, image, strength):
        result = image * strength
        return io.NodeOutput(result)
```

## V3 Node Class Structure

Every V3 node requires:

1. **Inherit from `io.ComfyNode`**
2. **`define_schema(cls)`** - classmethod returning `io.Schema`
3. **`execute(cls, ...)`** - classmethod performing the computation

```python
from typing_extensions import override
from comfy_api.latest import ComfyExtension, io

class ImageBrighten(io.ComfyNode):
    @classmethod
    def define_schema(cls):
        return io.Schema(
            node_id="ImageBrighten",          # unique identifier
            display_name="Brighten Image",     # shown in UI
            category="image/adjust",           # menu path
            description="Adjusts image brightness",
            inputs=[
                io.Image.Input("image"),
                io.Float.Input("factor", default=1.2, min=0.0, max=3.0, step=0.1),
            ],
            outputs=[
                io.Image.Output("IMAGE"),
            ],
        )

    @classmethod
    def execute(cls, image, factor):
        result = torch.clamp(image * factor, 0.0, 1.0)
        return io.NodeOutput(result)
```

## io.Schema Fields

```python
io.Schema(
    node_id="UniqueNodeID",            # required: unique string ID
    display_name="Display Name",        # optional: shown in UI menus
    category="category/subcategory",    # menu hierarchy (default "sd")
    description="Node description",     # optional: tooltip text
    inputs=[...],                       # list of Input objects
    outputs=[...],                      # list of Output objects
    hidden=[...],                       # list of Hidden enum values
    is_output_node=False,               # True for nodes with side effects (save, preview)
    is_experimental=False,              # marks as experimental
    is_deprecated=False,                # marks as deprecated
    is_dev_only=False,                  # hidden unless dev mode enabled
    is_api_node=False,                  # marks as API-only node
    is_input_list=False,                # receive full lists instead of individual items
    not_idempotent=False,               # no cache sharing between identical instances (see lifecycle)
    accept_all_inputs=False,            # accept arbitrary inputs via **kwargs
    enable_expand=False,                # allow node expansion (subgraphs)
    search_aliases=["alias1", "alias2"],# alternative search terms
    essentials_category="Basic",        # optional: Essentials tab category
    price_badge=None,                   # optional: PriceBadge for API nodes
    has_intermediate_output=False,      # True for nodes with interactive UI that produce intermediate outputs
    loop_boundary=None,                 # "start"/"end": core loop validation (v0.36+, experimental)
)
```

## V3 Node Registration

V3 nodes are registered via `ComfyExtension` and `comfy_entrypoint()`:

```python
from typing_extensions import override
from comfy_api.latest import ComfyExtension, io

class MyNode(io.ComfyNode):
    @classmethod
    def define_schema(cls):
        return io.Schema(
            node_id="MyNode",
            display_name="My Node",
            category="my_nodes",
            inputs=[io.String.Input("text", multiline=True)],
            outputs=[io.String.Output()],
        )

    @classmethod
    def execute(cls, text):
        return io.NodeOutput(text.upper())


class MyExtension(ComfyExtension):
    @override
    async def get_node_list(self) -> list[type[io.ComfyNode]]:
        return [MyNode]


async def comfy_entrypoint() -> MyExtension:
    return MyExtension()
```

The `comfy_entrypoint()` function must be defined at the module level (in the file directly imported by ComfyUI).

## V1 Node Structure (Legacy Reference)

V1 nodes use class attributes and `NODE_CLASS_MAPPINGS`:

```python
class MyNodeV1:
    CATEGORY = "my_category"
    FUNCTION = "execute"
    RETURN_TYPES = ("IMAGE",)
    RETURN_NAMES = ("image",)

    @classmethod
    def INPUT_TYPES(s):
        return {
            "required": {
                "image": ("IMAGE",),
                "strength": ("FLOAT", {"default": 1.0, "min": 0.0, "max": 1.0}),
            }
        }

    def execute(self, image, strength):
        return (image * strength,)

NODE_CLASS_MAPPINGS = {"MyNodeV1": MyNodeV1}
NODE_DISPLAY_NAME_MAPPINGS = {"MyNodeV1": "My Node V1"}
```

## Key Differences: V3 vs V1

| Aspect | V3 | V1 |
|---|---|---|
| Base class | `io.ComfyNode` | Plain class |
| Execute method | `execute` classmethod (fixed name) | Instance method (custom name via `FUNCTION`) |
| Inputs | `io.Schema(inputs=[...])` | `INPUT_TYPES()` dict |
| Outputs | `io.Schema(outputs=[...])` | `RETURN_TYPES` tuple |
| Return value | `io.NodeOutput(...)` | Plain tuple |
| Registration | `ComfyExtension` + `comfy_entrypoint()` | `NODE_CLASS_MAPPINGS` dict |
| State | No instance state (classmethods) | Instance state allowed |
| Hidden inputs | `cls.hidden.prompt`, etc. | kwargs from `"hidden"` dict |

## Important Rules

- `node_id` must be globally unique across all nodes
- `execute()` parameters must match input IDs exactly
- All methods are `@classmethod` in V3 (no instance state)
- Return `io.NodeOutput(val1, val2, ...)` matching output count
- Category uses `/` separator for hierarchy: `"image/transform"`
- Prefix category with `_` to hide from menus: `"_for_testing"`

## See Also

- `comfyui-node-datatypes` - Data types (IMAGE, LATENT, MASK, etc.)
- `comfyui-node-inputs` - Input configuration details
- `comfyui-node-outputs` - Output types and UI outputs
- `comfyui-node-packaging` - Project structure and packaging
- `comfyui-node-lifecycle` - Execution lifecycle and caching

© Terry Jia · MIT · jtydhr88/comfyui-custom-node-skills

Похожие скиллы

Каталог скиллов SKILL.md →
cli-anything-comfyui HKUDS Скилл cli-anything-comfyui даёт агенту консольный доступ к ComfyUI: ставить workflow в очередь, искать модели и скачивать готовые картинки без графического интерфейса. CX Codex +1 615установок comfyui NousResearch Подключает ComfyUI через REST/WebSocket API и comfy-cli. Запускает диффузионные пайплайны — от txt2img на Flux и SDXL до видео через AnimateDiff и Wan. CX Codex +1 405установок comfyui-media-workflows calesthio Скилл comfyui-media-workflows для Claude Code собирает и проверяет графы ComfyUI для генерации изображений и видео. Разбирает JSON/API и готовит запуск к передаче. CX Codex +1 156установок firebase-auth-basics Google LLC Скилл firebase-auth-basics для Claude Code описывает настройку Firebase Authentication, вход пользователей и правил доступа к данным. Настраивает авторизацию приложений. CX Codex +1 186 300установок firebase-hosting-basics Google LLC Скилл firebase-hosting-basics для Claude Code помогает развернуть сайт на Firebase Hosting и настроить его параметры. Он подключается к задачам со статическими сайтами, SPA, доменами и каналами предпросмотра. CX Codex +1 181 600установок bigquery-basics официальный google Скилл bigquery-basics управляет ресурсами BigQuery и запускает SQL-запросы. Подходит для создания датасетов, таблиц, представлений и базовой загрузки данных. CX Codex +1 17 678установок

Из того же набора10

Весь набор →
comfyui-node-packaging Скилл comfyui-node-packaging для упаковки и публикации кастомных нод ComfyUI: структура проекта, регистрация в __init__.py, requirements.txt, WEB_DIRECTORY. CX Codex +1 ★ 321звёзд репо comfyui-node-outputs Скилл comfyui-node-outputs для Claude Code описывает возврат данных из нод ComfyUI V3: io.NodeOutput, превью изображений, масок, аудио, видео и 3D-моделей. CX Codex +1 ★ 321звёзд репо comfyui-node-lifecycle Скилл comfyui-node-lifecycle объясняет жизненный цикл узлов ComfyUI: порядок выполнения, проверку входов и работу кэша. Пригодится при отладке и разработке пользовательских узлов. CX Codex +1 ★ 321звёзд репо comfyui-node-migration Скилл comfyui-node-migration переводит старые кастомные ноды ComfyUI с API V1 на V3: чек-лист по шагам, таблицы соответствия свойств и типов входов, пример до и после. CX Codex +1 ★ 321звёзд репо comfyui-node-inputs Скилл comfyui-node-inputs помогает настраивать типы входов и виджеты кастомных узлов ComfyUI. Пригодится при создании числовых полей, выпадающих списков, кривых и видеоредакторов. CX Codex +1 ★ 321звёзд репо comfyui-node-advanced Скилл comfyui-node-advanced для Claude Code помогает проектировать сложные узлы ComfyUI с динамическими входами и сопоставлением типов. Решает задачу узлов, которым недостаточно фиксированной схемы входов. CX Codex +1 ★ 321звёзд репо comfyui-node-datatypes Скилл comfyui-node-datatypes для Claude Code описывает типы входов и выходов нод ComfyUI. Включается при работе с форматами тензоров, моделей, аудио, видео, 3D и виджетов. CX Codex +1 ★ 321звёзд репо comfyui-node-frontend Скилл comfyui-node-frontend помогает создавать JavaScript-расширения для кастомных нод ComfyUI: настраивать хуки жизненного цикла, добавлять DOM-виджеты и менять поведение интерфейса. CX Codex +1 ★ 321звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой