# comfyui-node-basics

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 321 у репозитория
- Автор: Terry Jia
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/jtydhr88/comfyui-custom-node-skills/tree/HEAD/plugins/comfyui-custom-nodes/skills/comfyui-node-basics/SKILL.md
- Обновлён: 2026-10-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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. Он описывает структуру кода, а не создаёт узел автоматически: схему, вычисление и регистрацию нужно реализовать в проекте.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add jtydhr88/comfyui-custom-node-skills
```
В чате агента (не в терминале):
```text
/plugin install comfyui-custom-nodes@comfyui-custom-node-skills
```
Команда ставит плагин comfyui-custom-nodes целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/comfyui-node-basics/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/comfyui-node-basics/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jtydhr88/comfyui-custom-node-skills plugins/comfyui-custom-nodes/skills/comfyui-node-basics
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/comfyui-node-basics/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jtydhr88/comfyui-custom-node-skills --skill comfyui-node-basics -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jtydhr88/comfyui-custom-node-skills --path plugins/comfyui-custom-nodes/skills/comfyui-node-basics
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/comfyui-node-basics/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jtydhr88/comfyui-custom-node-skills/tree/HEAD/plugins/comfyui-custom-nodes/skills/comfyui-node-basics/SKILL.md

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

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

## Похожие
- [cli-anything-comfyui](https://affpapa.org/nevibecode/skills/cli-anything-comfyui.md) — скилл · 615 установок
- [comfyui](https://affpapa.org/nevibecode/skills/comfyui.md) — скилл · 405 установок
- [comfyui-media-workflows](https://affpapa.org/nevibecode/skills/comfyui-media-workflows.md) — скилл · 156 установок
- [firebase-auth-basics](https://affpapa.org/nevibecode/skills/firebase-auth-basics.md) — скилл · 186300 установок
- [firebase-hosting-basics](https://affpapa.org/nevibecode/skills/firebase-hosting-basics.md) — скилл · 181600 установок
- [bigquery-basics](https://affpapa.org/nevibecode/skills/bigquery-basics.md) — скилл · 17678 установок

Из того же набора: [jtydhr88/comfyui-custom-node-skills](https://affpapa.org/nevibecode/by/jtydhr88/comfyui-custom-node-skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
