comfyui-custom-node-skills

ComfyUI Custom Node Skills

A curated collection of agent skills (for Claude Code and OpenAI Codex) for developing ComfyUI custom nodes. These skills give the agent comprehensive knowledge of the ComfyUI node system, covering both the V3 (recommended) and V1 (legacy) APIs.

The SKILL.md files follow the open agentskills.io standard and are shared by both agents — install once, works everywhere.

中文说明

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

Claude Code

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

Codex (CLI / ChatGPT desktop app / IDE extension)

Plugin marketplace (recommended)

# Add this repository as a Codex marketplace source
codex plugin marketplace add jtydhr88/comfyui-custom-node-skills

# Then, in the ChatGPT desktop app or Codex CLI:
# Plugins → select "ComfyUI Custom Node Skills" → Install

The same 9 SKILL.md files are shipped through the plugin's skills/ directory — no duplication, no rewriting.

Personal skills (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-* ~/.agents/skills/

Project-specific

# Copy skills into your ComfyUI custom node project
mkdir -p .agents/skills
cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* .agents/skills/

Verify

In Codex, run /skills to list available skills, or invoke one explicitly with $comfyui-node-basics.

Usage Examples

# "Create a basic V3 node with an image input and a float slider"
# → agent uses comfyui-node-basics + comfyui-node-inputs

# "Add a preview image output to my node"
# → agent uses comfyui-node-outputs

# "Migrate my V1 node to V3"
# → agent uses comfyui-node-migration

# "Add a sidebar tab with custom settings"
# → agent 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
• Multi-agent — Same SKILL.md files work in Claude Code and Codex (open agentskills.io standard)

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