comfyui-node-change

name	comfyui-node-change
description	Use when changing ComfyUI node classes, schemas, inputs, outputs, metadata, or registration.

ComfyUI Node Change

Use this skill for changes under nodes/ or __init__.py that affect node behavior or ComfyUI schema.

Read First

• AGENTS.md
• Relevant docs/requirements/*.md
• Relevant docs/adr/*.md
• Existing Classic and Flow implementations if the change touches shared behavior

Rules

• Preserve graph compatibility unless the user explicitly approves a break.
• Keep node_id, socket names, socket order, defaults, categories, and metadata stable when possible.
• Prefer shared helpers only when both Classic and Flow genuinely use the same behavior.
• Keep ComfyUI imports at the node boundary where possible. Pure math and parsing helpers should remain testable without a ComfyUI runtime.
• Validate inputs early and return clear errors or safe fallback output.

Checks

Run:

python3 scripts/validate_repo.py

When a ComfyUI environment is available, also load the node in ComfyUI and exercise at least one small workflow.