Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jtydhr88--comfyui-custom-node-skills/badge.svg)](/listings/jtydhr88--comfyui-custom-node-skills)

HTML

<a href="/listings/jtydhr88--comfyui-custom-node-skills"><img src="/api/listings/jtydhr88--comfyui-custom-node-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "comfyui-custom-node-skills",
  3. "owner": {
  4. "name": "Terry Jia"
  5. },
  6. "metadata": {
  7. "description": "Skills for building ComfyUI custom nodes with the V3 and V1 Python APIs"
  8. },
  9. "plugins": [
  10. {
  11. "name": "comfyui-custom-nodes",
  12. "source": "./plugins/comfyui-custom-nodes",
  13. "description": "9 skills covering ComfyUI custom node development with the V3 and V1 APIs"
  14. }
  15. ]
  16. }
README.md · README · 155 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # ComfyUI Custom Node Skills
  2. A curated collection of agent skills (for [Claude Code](https://docs.anthropic.com/en/docs/claude-code/skills) and [OpenAI Codex](https://developers.openai.com/codex/build-skills)) 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.
  3. The `SKILL.md` files follow the open [agentskills.io](https://agentskills.io) standard and are shared by both agents — install once, works everywhere.
  4. > **[中文说明](README_ZH.md)**
  5. ## Skills Overview
  6. | Skill | Trigger | Description |
  7. |---|---|---|
  8. | **comfyui-node-basics** | Creating nodes, defining classes, project setup | V3 node structure, `io.Schema`, inputs/outputs, `ComfyExtension` registration |
  9. | **comfyui-node-inputs** | Configuring widgets, adding inputs | INT, FLOAT, STRING, BOOLEAN, COMBO, hidden/optional/lazy inputs, `force_input` |
  10. | **comfyui-node-outputs** | Returning results, previews, saving files | `NodeOutput`, `PreviewImage/Mask/Audio/Text`, `SavedImages`, UI helpers |
  11. | **comfyui-node-datatypes** | Working with tensors, model types | IMAGE, LATENT, MASK, CONDITIONING, MODEL, CLIP, VAE, AUDIO, VIDEO, 3D, custom types |
  12. | **comfyui-node-advanced** | Dynamic inputs, type matching, expansion | MatchType, Autogrow, DynamicCombo, `GraphBuilder`, MultiType, async |
  13. | **comfyui-node-lifecycle** | Execution debugging, caching, validation | `fingerprint_inputs`, `validate_inputs`, `check_lazy_status`, execution order |
  14. | **comfyui-node-frontend** | UI features, custom widgets, extensions | JS hooks, sidebar tabs, commands, settings, toasts, dialogs, context menus |
  15. | **comfyui-node-migration** | Converting V1 nodes to V3 | Property mapping, method conversion, registration changes |
  16. | **comfyui-node-packaging** | Project setup, publishing | Directory layout, `__init__.py`, `pyproject.toml`, `WEB_DIRECTORY`, registry publishing |
  17. ## Installation
  18. ### Claude Code
  19. #### Plugin Marketplace (recommended)
  20. 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.
  21. #### Personal (all projects)
  22. ```bash
  23. # Clone the repository, then copy the skills to your personal skills directory
  24. git clone https://github.com/jtydhr88/comfyui-custom-node-skills.git
  25. cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* ~/.claude/skills/
  26. ```
  27. #### Project-specific
  28. ```bash
  29. # Copy skills into your ComfyUI custom node project
  30. cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* /path/to/your-project/.claude/skills/
  31. ```
  32. #### Verify
  33. Skills are loaded automatically when Claude detects relevant context. You can also check they're available:
  34. ```
  35. > /skills
  36. ```
  37. ### Codex (CLI / ChatGPT desktop app / IDE extension)
  38. #### Plugin marketplace (recommended)
  39. ```bash
  40. # Add this repository as a Codex marketplace source
  41. codex plugin marketplace add jtydhr88/comfyui-custom-node-skills
  42. # Then, in the ChatGPT desktop app or Codex CLI:
  43. # Plugins → select "ComfyUI Custom Node Skills" → Install
  44. ```
  45. The same 9 `SKILL.md` files are shipped through the plugin's `skills/` directory — no duplication, no rewriting.
  46. #### Personal skills (all projects)
  47. ```bash
  48. # Clone the repository, then copy the skills to your personal skills directory
  49. git clone https://github.com/jtydhr88/comfyui-custom-node-skills.git
  50. cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* ~/.agents/skills/
  51. ```
  52. #### Project-specific
  53. ```bash
  54. # Copy skills into your ComfyUI custom node project
  55. mkdir -p .agents/skills
  56. cp -r comfyui-custom-node-skills/plugins/comfyui-custom-nodes/skills/comfyui-node-* .agents/skills/
  57. ```
  58. #### Verify
  59. In Codex, run `/skills` to list available skills, or invoke one explicitly with `$comfyui-node-basics`.
  60. ### GitHub Copilot
  61. #### Automatic (cloud and local VSCode)
  62. 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.
  63. #### Plugin marketplace (Copilot CLI — recommended)
  64. ```bash
  65. # Register the marketplace (once)
  66. copilot plugin marketplace add jtydhr88/comfyui-custom-node-skills
  67. # Browse and install
  68. copilot plugin marketplace browse comfyui-custom-node-skills
  69. copilot plugin install comfyui-custom-nodes@comfyui-custom-node-skills
  70. ```
  71. #### Direct install (Copilot CLI)
  72. ```bash
  73. copilot plugin install jtydhr88/comfyui-custom-node-skills:plugins/comfyui-custom-nodes
  74. ```
  75. #### Verify
  76. ```text
  77. /skills list
  78. ```
  79. ## Usage Examples
  80. ```
  81. # "Create a basic V3 node with an image input and a float slider"
  82. # → agent uses comfyui-node-basics + comfyui-node-inputs
  83. # "Add a preview image output to my node"
  84. # → agent uses comfyui-node-outputs
  85. # "Migrate my V1 node to V3"
  86. # → agent uses comfyui-node-migration
  87. # "Add a sidebar tab with custom settings"
  88. # → agent uses comfyui-node-frontend
  89. ```
  90. ## Key Features
  91. - **V3 API First** — All examples use the modern V3 API (`io.ComfyNode`, `io.Schema`, `io.NodeOutput`)
  92. - **V1 Reference** — Legacy V1 patterns documented for migration and backward compatibility
  93. - **Source-Verified** — Cross-referenced against actual ComfyUI backend and frontend source code
  94. - **Complete Coverage** — From basic node creation to advanced patterns like DynamicCombo and node expansion
  95. - **Frontend Extensions** — Full JavaScript extension system with 15+ lifecycle hooks
  96. - **Multi-agent** — Same `SKILL.md` files work in Claude Code and Codex (open agentskills.io standard)
  97. ## Sources
  98. Built from and verified against:
  99. - [ComfyUI backend](https://github.com/comfyanonymous/ComfyUI) — V3 API at `comfy_api/latest/`, V1 at `comfy/comfy_types/`
  100. - Last verified: `a2840e75` — Make ImageUpscaleWithModel node work with intermediate device and dtype. (#13357)
  101. - [ComfyUI frontend](https://github.com/Comfy-Org/ComfyUI_frontend) — Extension system, widget types, settings
  102. - Last verified: `6f579c59` — fix: enable playwright/no-force-option lint rule (#11164)
  103. - [ComfyUI docs](https://docs.comfy.org/custom-nodes/overview) — Official guides and references
  104. - Built-in node implementations in `comfy_extras/`
  105. ## License
  106. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.