Agent skill

Debug Comfy Workflow

by peteromallet in peteromallet/VibeComfy

Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production.

MITAuto-check passedAI & LLM Engineering

Install Debug Comfy Workflow

skills CLI
$ npx skills add peteromallet/VibeComfy --skill debug-comfy-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install peteromallet/VibeComfy debug-comfy-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/peteromallet/VibeComfy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/agent-skill/skills/debug-comfy-workflow .claude/skills/debug-comfy-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debug-comfy-workflow
GitHub stars
150
Token cost
~609 tokens
SKILL.md length
202 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production.

  • The user asks why a workflow does not run
  • SKILL.md covers First Pass, Missing Nodes Or Models and Discipline
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Has missing nodes/models

What it does

Debug Comfy Workflow is an agent skill from peteromallet/VibeComfy. Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production. Use when the user asks why a workflow does not run, has missing nodes/models, validation errors, bad wiring, failed RunPod/local runs, or confusing agent-edit failures.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Diffusion and image models. It works with ComfyUI. The licence is MIT.

When your agent uses it

  • The user asks why a workflow does not run
  • Has missing nodes/models
  • Validation errors
  • Failed RunPod/local runs

Example prompts

  • “/debug-comfy-workflow”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b1429c6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debug Comfy Workflow loads about 609 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~609

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from peteromallet/VibeComfy at commit b1429c6, republished under its MIT licence (© peteromallet). 202 words, ~609 tokens.

Download SKILL.mdSave it as .claude/skills/debug-comfy-workflow/SKILL.md (or your agent's skills folder).
name
debug-comfy-workflow
description
Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production. Use when the user asks why a workflow does not run, has missing nodes/models, validation errors, bad wiring, failed RunPod/local runs, or confusing agent-edit failures.

Debug Comfy Workflow

Debug from cheap static evidence toward expensive runtime evidence. Decide first whether the failure is the graph, dependencies, or the runtime.

First Pass

bash
vibecomfy inspect <workflow>
vibecomfy validate <workflow>
vibecomfy doctor <workflow> --json
vibecomfy analyze info <workflow>

For source JSON or conversion failures, keep the source as import evidence and do not execute its API export directly:

bash
vibecomfy import <workflow.json>
vibecomfy validate workflows/<source-stem> --json
vibecomfy port doctor-all <workflow.json> --json
vibecomfy port widgets <workflow.json> --json

For runtime failures:

bash
vibecomfy runtime doctor
vibecomfy logs tail
vibecomfy watchdog list

Missing Nodes Or Models

bash
vibecomfy nodes install-plan <workflow>
vibecomfy nodes spec <ClassType>
vibecomfy fetch <workflow> --dry-run
vibecomfy models stage --select-phase core --dry-run

Install or download only after the evidence supports it and the user agrees.

For custom Python failures, separate these cases:

  • malformed io, unknown bindings, or an invalid result shape: fix the node declaration or explicit adapter;
  • missing declared distribution: prepare the selected worker with setup tools;
  • missing snapshot member, archive/member digest mismatch, unsafe path, or absolute snapshot self-import: recapture with relative imports or use the installed-entrypoint mode;
  • source traceback: inspect the reported source entrypoint and runtime line;
  • changed bundle/source revision: reload and retry the canonical transaction.

Discipline

  • Keep graph errors separate from environment errors.
  • If embedded ComfyUI is not discoverable, use vibecomfy-setup; that is not a workflow bug.
  • Do not recommend arbitrary node packs. Require nodes install-plan, lockfile data, registry evidence, or a concrete precedent.
  • If class/schema evidence is missing, use search-comfy-workflows before patching.
  • Preserve report paths and cite the exact command output or file that supports the diagnosis.

© peteromallet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/agent-skill/skills/debug-comfy-workflow of peteromallet/VibeComfy.

Open the folder on GitHubat commit b1429c6

Compare with similar skills

Debug Comfy Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debug Comfy Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Comfy Workflow this skillpeteromallet/VibeComfy150—~609Automated safety check: PassMIT
Comfyui AnimatoolShiroEirin/comfyui-good-anima476—~4.6kAutomated safety check: PassGPL-3.0
Comfyui Agent Skill MieMieMieeeee/comfyui-agent-skill116—~3.9kAutomated safety check: PassApache-2.0
Importing SubgraphsComfy-Org/workflow_templates1.3k—~1.5kAutomated safety check: PassMIT
Comfyui Node Addernixified-ai/flake841—~806Automated safety check: PassAGPL-3.0
Managing BundlesComfy-Org/workflow_templates1.3k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Comfyui Animatool

    ShiroEirin/comfyui-good-anima

    Route ALL Anima image generation: validate Danbooru hard anchors, form visual brief, assemble English prompts and args, then load comfyui-manager for workflow execution.

    476 GitHub stars~4.6k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Comfyui Agent Skill Mie

    MieMieeeee/comfyui-agent-skill

    Agent skill for running registered ComfyUI workflows through a stable CLI, and for importing a user's own ComfyUI workflow into their private registry after review.

    116 GitHub stars~3.9k tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed
  • Importing Subgraphs

    Comfy-Org/workflow_templates

    Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository.

    1.3k GitHub stars~1.5k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Comfyui Node Adder

    nixified-ai/flake

    Adds new custom nodes to the ComfyUI Nix project, including npins fetching, dependency resolution in package.nix, disabling impure pip installs, and verifying the Nix build.

    841 GitHub stars~806 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Managing Bundles

    Comfy-Org/workflow_templates

    Manages template bundles, categories, and ordering in the ComfyUI template repository.

    1.3k GitHub stars~1.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Headroom

    momori777/Artemis

    SmartCrusher + CCR context compression — crunch large JSON arrays, tool outputs, and search results to save tokens.

    377 GitHub stars~562 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed

More from peteromallet/VibeComfy

All 9 skills in this repo
  • Add Comfy Workflow Template

    peteromallet/VibeComfy

    Add a durable VibeComfy ready workflow/template from a ComfyUI source workflow.

    150 GitHub stars~700 tokensUpdated 6 days ago
    Auto-check passed
  • Edit Comfy Workflow

    peteromallet/VibeComfy

    Edit an existing VibeComfy or ComfyUI workflow, ready template, recipe, scratchpad, or target graph.

    150 GitHub stars~2.2k tokensUpdated 6 days ago
    Auto-check passed
  • Explain Comfy Workflow

    peteromallet/VibeComfy

    Explain an existing VibeComfy or ComfyUI workflow, ready template, recipe, scratchpad, target graph, node chain, model path, prompt path, or runtime result.

    150 GitHub stars~806 tokensUpdated 6 days ago
    Auto-check passed
  • Reorganise Comfy Workflow

    peteromallet/VibeComfy

    Reorganise an existing ComfyUI workflow layout without changing runtime behavior.

    150 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Run Comfy Workflow

    peteromallet/VibeComfy

    Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs.

    150 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed
  • Search Comfy Workflows

    peteromallet/VibeComfy

    Search for ComfyUI workflow precedents, VibeComfy ready templates, node wiring examples, Banodoco/Hivemind community workflow knowledge, and concrete graph patterns before editing or adding a…

    150 GitHub stars~966 tokensUpdated 6 days ago
    Auto-check passed

Works with

Questions about Debug Comfy Workflow

What does Debug Comfy Workflow do?

Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production. Debug Comfy Workflow is an agent skill from peteromallet/VibeComfy. Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production.

When should I use Debug Comfy Workflow?

Debug Comfy Workflow fits situations like: the user asks why a workflow does not run; has missing nodes/models; validation errors; failed RunPod/local runs.

How do I install Debug Comfy Workflow in Claude Code?

Run `npx skills add peteromallet/VibeComfy --skill debug-comfy-workflow -a claude-code`. Or copy the skill folder (docs/agent-skill/skills/debug-comfy-workflow in peteromallet/VibeComfy) into .claude/skills/debug-comfy-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Debug Comfy Workflow in Codex?

Run `npx skills add peteromallet/VibeComfy --skill debug-comfy-workflow -a codex`. Or copy the skill folder (docs/agent-skill/skills/debug-comfy-workflow in peteromallet/VibeComfy) into .agents/skills/debug-comfy-workflow in your project. Codex loads it when a task matches its description.

Can I use Debug Comfy Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add peteromallet/VibeComfy --skill debug-comfy-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debug-comfy-workflow, .gemini/skills/debug-comfy-workflow, .github/skills/debug-comfy-workflow and .opencode/skills/debug-comfy-workflow in your project.

What does Debug Comfy Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Debug Comfy Workflow is instructions for the agent only. Our summary lists: Python 3.

Does Debug Comfy Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Debug Comfy Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Debug Comfy Workflow use?

Debug Comfy Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debug Comfy Workflow use?

About 609 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debug Comfy Workflow?

Skills that share tags, products or a category with Debug Comfy Workflow: Comfyui Animatool (ShiroEirin/comfyui-good-anima, 476 stars), Comfyui Agent Skill Mie (MieMieeeee/comfyui-agent-skill, 116 stars), Importing Subgraphs (Comfy-Org/workflow_templates, 1.3k stars) and Comfyui Node Adder (nixified-ai/flake, 841 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Comfy Workflow?

peteromallet (a GitHub user) maintains it in peteromallet/VibeComfy, which has 150 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 1, 2026.

Source: peteromallet/VibeComfy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.