Directory · #331 trending skills repo · ↗ +4 stars this week
Comfyui Custom Node Skills
jtydhr88/comfyui-custom-node-skills
A curated collection of [Claude Code skills](https://docs.anthropic.com/en/docs/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.
- Stars
- 317
- This week
- +4
- Forks
- 30
- Open issues
- 0
- Skills inside
- 9
Get started
Install the skills
npx skills add jtydhr88/comfyui-custom-node-skillsInstalls into Claude Code, Codex, Cursor, OpenCode and the other agents it finds on your machine.
/plugin marketplace add jtydhr88/comfyui-custom-node-skillsRun inside Claude Code, then pick what to install from /plugin.
git clone --depth 1 https://github.com/jtydhr88/comfyui-custom-node-skills.git /tmp/comfyui-custom-node-skills
cp -r /tmp/comfyui-custom-node-skills ~/.claude/skills/comfyui-custom-node-skillsClaude Code reads ~/.claude/skills/ (or .claude/skills/ in a project). Other agents read the same SKILL.md format from their own skills folder.
Inside this repo
9 skills
plugins/comfyui-custom-nodes/skills/comfyui-node-advancedcomfyui-node-basicsComfyUI 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.plugins/comfyui-custom-nodes/skills/comfyui-node-basicscomfyui-node-datatypesComfyUI data types - IMAGE, LATENT, MASK, CONDITIONING, MODEL, CLIP, VAE, AUDIO, VIDEO, 3D types, widget types, and custom types. Use when working with ComfyUI tensors, model types, or defining input/output data types.plugins/comfyui-custom-nodes/skills/comfyui-node-datatypescomfyui-node-frontendComfyUI frontend JavaScript extensions - hooks, widgets, sidebar tabs, commands, settings, toasts, dialogs. Use when adding UI features to custom nodes, creating custom widgets, or extending the ComfyUI frontend.plugins/comfyui-custom-nodes/skills/comfyui-node-frontendcomfyui-node-inputsComfyUI node input types - INT, FLOAT, STRING, BOOLEAN, COMBO widgets, hidden inputs, optional inputs, lazy inputs, force_input. Use when configuring node inputs, adding widgets, or customizing input behavior.plugins/comfyui-custom-nodes/skills/comfyui-node-inputscomfyui-node-lifecycleComfyUI node execution lifecycle - caching, fingerprint_inputs/IS_CHANGED, validate_inputs/VALIDATE_INPUTS, check_lazy_status, execution order. Use when debugging execution, implementing caching control, input validation, or understanding execution flow.plugins/comfyui-custom-nodes/skills/comfyui-node-lifecyclecomfyui-node-migrationComfyUI V1 to V3 node migration - converting legacy nodes to the V3 API. Use when migrating existing custom nodes from V1 to V3, understanding differences between API versions, or modernizing node code.plugins/comfyui-custom-nodes/skills/comfyui-node-migrationcomfyui-node-outputsComfyUI node output types - NodeOutput, UI outputs, PreviewImage, PreviewMask, SavedImages, PreviewAudio, PreviewText, PreviewVideo, Saved3DModels. Use when returning results from nodes, displaying previews, or saving output files.plugins/comfyui-custom-nodes/skills/comfyui-node-outputscomfyui-node-packagingComfyUI custom node project structure - directory layout, __init__.py, registration, requirements.txt, publishing, WEB_DIRECTORY. Use when setting up a new custom node project, packaging nodes, or publishing to the registry.plugins/comfyui-custom-nodes/skills/comfyui-node-packagingDocumentation
README
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.
GitHub Copilot
Automatic (cloud and local VSCode)
The .github/copilot-instructions.md file is read automatically by GitHub Copilot as repository-wide instructions in both cloud and local VSCode contexts — no setup needed. To make the Skills themselves available, install the plugin via the Copilot CLI using the marketplace or direct install steps below.
Plugin marketplace (Copilot CLI — recommended)
# Register the marketplace (once)
copilot plugin marketplace add jtydhr88/comfyui-custom-node-skills
# Browse and install
copilot plugin marketplace browse comfyui-custom-node-skills
copilot plugin install comfyui-custom-nodes@comfyui-custom-node-skills
Direct install (Copilot CLI)
copilot plugin install jtydhr88/comfyui-custom-node-skills:plugins/comfyui-custom-nodes
Verify
/skills list
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.mdfiles 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 atcomfy/comfy_types/- Last verified:
a2840e75— Make ImageUpscaleWithModel node work with intermediate device and dtype. (#13357)
- Last verified:
- ComfyUI frontend — Extension system, widget types, settings
- Last verified:
6f579c59— fix: enable playwright/no-force-option lint rule (#11164)
- Last verified:
- ComfyUI docs — Official guides and references
- Built-in node implementations in
comfy_extras/
License
MIT