ComfyUI Custom Node Skills for Claude Code
A curated collection of Claude Code skills for developing ComfyUI custom nodes. These skills give Claude comprehensive knowledge of the ComfyUI node system, covering both the V3 (recommended) and V1 (legacy) APIs.
中文说明
Skills Overview
| Skill | Trigger | Description |
|---|
| comfyui-node-basics | Creating nodes, defining classes, project setup | V3 node structure, io.Schema, inputs/outputs, ComfyExtension registration |
| comfyui-node-inputs | Configuring widgets, adding inputs | INT, FLOAT, STRING, BOOLEAN, COMBO, hidden/optional/lazy inputs, force_input |
| comfyui-node-outputs | Returning results, previews, saving files | NodeOutput, PreviewImage/Mask/Audio/Text, SavedImages, UI helpers |
| comfyui-node-datatypes | Working with tensors, model types | IMAGE, LATENT, MASK, CONDITIONING, MODEL, CLIP, VAE, AUDIO, VIDEO, 3D, custom types |
| comfyui-node-advanced | Dynamic inputs, type matching, expansion | MatchType, Autogrow, DynamicCombo, GraphBuilder, MultiType, async |
| comfyui-node-lifecycle | Execution debugging, caching, validation | fingerprint_inputs, validate_inputs, check_lazy_status, execution order |
| comfyui-node-frontend | UI features, custom widgets, extensions | JS hooks, sidebar tabs, commands, settings, toasts, dialogs, context menus |
| comfyui-node-migration | Converting V1 nodes to V3 | Property mapping, method conversion, registration changes |
| comfyui-node-packaging | Project setup, publishing | Directory layout, __init__.py, pyproject.toml, WEB_DIRECTORY, registry publishing |
Installation
Plugin Marketplace (recommended)
In Claude Code, open the marketplace and add this repository URL. This installs the comfyui-custom-nodes plugin, which exposes all 9 skills automatically — no manual copying required.
Personal (all projects)
# Clone the repository, then copy the skills to your personal skills directory
git clone https://github.com/jtydhr88/comfyui-custom-node-skills.git
cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* ~/.claude/skills/
Project-specific
# Copy skills into your ComfyUI custom node project
cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* /path/to/your-project/.claude/skills/
Verify
Skills are loaded automatically when Claude detects relevant context. You can also check they're available:
> /skills
Usage Examples
# "Create a basic V3 node with an image input and a float slider"
# → Claude uses comfyui-node-basics + comfyui-node-inputs
# "Add a preview image output to my node"
# → Claude uses comfyui-node-outputs
# "Migrate my V1 node to V3"
# → Claude uses comfyui-node-migration
# "Add a sidebar tab with custom settings"
# → Claude uses comfyui-node-frontend
Key Features
- V3 API First — All examples use the modern V3 API (
io.ComfyNode, io.Schema, io.NodeOutput)
- V1 Reference — Legacy V1 patterns documented for migration and backward compatibility
- Source-Verified — Cross-referenced against actual ComfyUI backend and frontend source code
- Complete Coverage — From basic node creation to advanced patterns like DynamicCombo and node expansion
- Frontend Extensions — Full JavaScript extension system with 15+ lifecycle hooks
Sources
Built from and verified against:
- ComfyUI backend — V3 API at
comfy_api/latest/, V1 at comfy/comfy_types/
- Last verified:
a2840e75 — Make ImageUpscaleWithModel node work with intermediate device and dtype. (#13357)
- ComfyUI frontend — Extension system, widget types, settings
- Last verified:
6f579c59 — fix: enable playwright/no-force-option lint rule (#11164)
- ComfyUI docs — Official guides and references
- Built-in node implementations in
comfy_extras/
License
MIT
