ComfyUI Custom Node Skills
Девять скиллов для Claude Code и Codex: агент пишет пользовательские узлы ComfyUI на V3 API по сверенному с исходниками описанию
- 319 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Только инструкции в формате Markdown: скиллы сами ничего не запускают и никуда не обращаются
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/comfyui-custom-node-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Только инструкции в формате Markdown: скиллы сами ничего не запускают и никуда не обращаются
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор из девяти скиллов учит агента писать пользовательские узлы ComfyUI. Примеры построены на V3 API: узел наследует `io.ComfyNode`, описывает схему через `io.Schema`, возвращает `io.NodeOutput` и регистрируется через `ComfyExtension`. Старый V1 описан для переноса и совместимости. Скиллы делят тему на части. `comfyui-node-basics` рассказывает про структуру узла и регистрацию, `comfyui-node-inputs` про виджеты и типы входов (INT, FLOAT, STRING, BOOLEAN, COMBO, скрытые, необязательные и ленивые), `comfyui-node-outputs` про результаты, предпросмотр и сохранение файлов, `comfyui-node-datatypes` про тензоры и типы вроде IMAGE, LATENT, MASK, CONDITIONING, MODEL, CLIP, VAE, AUDIO и VIDEO. `comfyui-node-advanced` разбирает динамические входы, `MatchType`, `Autogrow`, `DynamicCombo`, `GraphBuilder` и асинхронность. Остальные три: `comfyui-node-lifecycle` про кэш, проверку входов и порядок выполнения, `comfyui-node-frontend` про расширения на JavaScript, боковые вкладки и настройки, `comfyui-node-migration` про перенос узлов с V1 на V3. Девятый, `comfyui-node-packaging`, описывает структуру проекта, `pyproject.toml`, `WEB_DIRECTORY` и публикацию в реестре. Описание сверено с исходниками бэкенда и фронтенда ComfyUI и документацией.
Для кого. Разработчикам, которые пишут свои узлы для ComfyUI и просят Claude Code, Codex или GitHub Copilot написать узел, настроить входы или перенести старый код.
Подходит, если
- Нужен узел ComfyUI с картинкой на входе и ползунком типа FLOAT, и агент должен писать его сразу на V3
- Узел V1 надо перенести на V3: сопоставить свойства, методы и регистрацию
- Узел должен показывать предпросмотр изображения или сохранять файлы через `SavedImages`
- Расширению нужна боковая вкладка, свои виджеты или диалоги на JavaScript
- Пакет узлов готовят к публикации в реестре: структура каталога, `__init__.py`, `pyproject.toml`
Не подходит, если
- Нужно управлять самим ComfyUI из агента, запускать воркфлоу и генерировать картинки: скиллы учат писать узлы
- Задача решается готовыми узлами и воркфлоу без нового кода
- Узлы пишутся не для ComfyUI
- Проект привязан к API старой версии, и миграция на V3 не планируется
Пример запроса к агенту
Создай узел ComfyUI на V3 API: вход IMAGE и FLOAT, выход IMAGE, затем добавь предпросмотр результатаОграничения
- Описание привязано к V3 API (`comfy_api/latest/`) на дату сверки: в README указаны коммиты бэкенда и фронтенда, с которыми проверяли. Новые изменения ComfyUI могут ее обогнать.
- Скиллы ничего не запускают и не генерируют: они только дают агенту знания о написании узлов.
- Для ручной установки в Claude Code нужно клонировать репозиторий и копировать папки `comfyui-node-*`, а способ через маркетплейс зависит от клиента.
Как отключить. Удалите скопированные папки `comfyui-node-*` из `~/.claude/skills/`, `~/.agents/skills/` или из `.claude/skills/` проекта. Плагин убирается через меню плагинов клиента.
Частые вопросы
Как поставить скиллы для узлов ComfyUI в Claude Code?
Через маркетплейс клиента: в Claude Code добавьте адрес репозитория, и плагин `comfyui-custom-nodes` откроет все девять скиллов. Вручную клонируйте репозиторий и скопируйте папки `comfyui-node-*` из `plugins/comfyui-custom-nodes/skills/` в `~/.claude/skills/`.
Как поставить их в Codex?
Командой `codex plugin marketplace add jtydhr88/comfyui-custom-node-skills`, потом выберите плагин в списке и нажмите установку. Те же файлы `SKILL.md` работают в Codex без переписывания, личные скиллы кладут в `~/.agents/skills/`.
Чем V3 API отличается от V1?
В V3 узел наследует `io.ComfyNode`, схему задает `io.Schema`, результат возвращает `io.NodeOutput`, а регистрируется через `ComfyExtension`. Скилл `comfyui-node-migration` ведет перенос: сопоставляет свойства, методы и регистрацию.
Скиллы запускают ComfyUI?
Нет, они дают знания для написания кода узлов, ComfyUI они не запускают и картинки не генерируют. Для управления самим ComfyUI из агента берут другие инструменты.
Какие агенты поддерживаются?
Claude Code и OpenAI Codex, плюс GitHub Copilot через плагин в Copilot CLI. Файлы `SKILL.md` написаны по открытому стандарту agentskills.io, поэтому одни и те же скиллы ставятся в оба агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДевять личных скиллов инженера: цепочка от идеи до PR, поиск стандартов, песочница с циклом ревью и страницы-разборы изменений
skills-npm подключает скиллы агентов из зависимостей проекта в node_modules и из поля skills в package.json
15 скиллов для Claude Code и Codex: Laravel, Docker, UI, отладка, тесты и документация в четырех готовых плагин-пакетах
Библиотека скиллов для Claude Code, Cursor и Codex: ревью командой агентов, TDD, стековые PR, оценка готовности репозитория
Свыше 1100 готовых скиллов для Claude Code, Codex, Gemini CLI и Cursor и MCP-сервер, который подбирает скилл под задачу
Набор скиллов из реальной работы: аудит цепочки поставок npm, сборка CLI, релиз плагина Obsidian и иерархия AGENTS.md
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ComfyUI Custom Node Skills (эта карточка) | нет | 319 | ||
| ComfyUI-Agent-Kit | нет | 121 | скилл и MCP-драйвер для управления локальным ComfyUI, а эти скиллы учат писать собственные узлы | |
| ComfyUI MCP Server | нет | не нужна | 413 | MCP-сервер, через который агент генерирует картинки в ComfyUI, а здесь знания для разработки узлов |
Коротко о README
В README перечислены девять скиллов с триггерами, затем идут установка в Claude Code, Codex и GitHub Copilot, примеры запросов и особенности: V3 первым, справочник V1, сверка с исходниками, фронтенд-расширения. В конце названы источники и коммиты сверки.
Бейдж для README
Исходный SKILL.md
---
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