# comfyui-node-outputs

Скилл comfyui-node-outputs для Claude Code описывает возврат данных из нод ComfyUI V3: io.NodeOutput, превью изображений, масок, аудио, видео и 3D-моделей.

- скилл · `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-outputs/SKILL.md
- Обновлён: 2026-10-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/comfyui-node-outputs

## Что делает

Скилл объясняет агенту структуру возвращаемых значений в нодах ComfyUI V3 API. Он задаёт правила для `io.NodeOutput`, где позиционные аргументы обязаны строго повторять порядок полей из `outputs` схемы ноды. Ошибки в последовательности ломают граф выполнения.

Внутри описаны готовые UI-хелперы из модуля `comfy_api.latest`. В их числе показ картинок через `ui.PreviewImage`, автоконвертация масок в трёхканальный ч/б через `ui.PreviewMask`, отдача звука в FLAC и сохранение кадров во временную папку. Для версий от v0.40 показана работа с `ui.Saved3DModels`, которая отдаёт модели как стандартный элемент очереди `"3d"` вместе с матрицами трансформаций и параметрами камеры.

Для сохранения файлов приведён класс `ui.ImageSaveHelper` с методами под обычные PNG, анимированные PNG и WebP. Любая попытка вернуть превью без вызова `is_output_node=True` в схеме оставит ноду без отображения в интерфейсе.

## Установка

### 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-outputs -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/comfyui-node-outputs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/comfyui-node-outputs/

### Codex

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

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

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/comfyui-node-outputs/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-outputs
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/comfyui-node-outputs/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-outputs/SKILL.md

## Когда брать
- настроить возврат тензоров и списков через io.NodeOutput
- добавить показ превью картинок, аудио или масок на ноде
- подключить стандартный вывод 3D-моделей для ComfyUI v0.40+
- сохранить сгенерированные кадры в PNG или анимированный WebP

## Примеры запросов агенту
- Покажи, как оформить выход ноды с превью маски через comfyui-node-outputs
- Сделай ноду сохранения анимированного WebP с параметрами качества
- Как вернуть 3D-модель в формате Saved3DModels с настройками камеры?

## Похожие
- [cli-anything-comfyui](https://affpapa.org/nevibecode/skills/cli-anything-comfyui.md) — скилл · 615 установок
- [comfyui](https://affpapa.org/nevibecode/skills/comfyui.md) — скилл · 405 установок
- [comfyui-lowvram-setup](https://affpapa.org/nevibecode/skills/comfyui-lowvram-setup.md) — скилл · ★ 51 у репозитория
- [comfyui-mcp](https://affpapa.org/nevibecode/mcp/comfyui-mcp.md) — MCP-сервер · ★ 946 у репозитория
- [comfyui-mcp-server](https://affpapa.org/nevibecode/mcp/comfyui-mcp-server.md) — MCP-сервер · ★ 10 у репозитория
- [ComfyUI Builder](https://affpapa.org/nevibecode/mcp/comfyui-builder.md) — MCP-сервер · ★ 5 у репозитория

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

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