comfy-debug

Diagnose comfy-cli failures by mapping JSON envelope errors to recovery actions.

931|144|Updated Apr 14, 2024
One-click install
npx skills add https://github.com/Comfy-Org/comfy-cli --skill comfy-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comfy-debug
Source: https://github.com/Comfy-Org/comfy-cli/tree/main/comfy_cli/skills/comfy-debug
Command: npx skills add https://github.com/Comfy-Org/comfy-cli --skill comfy-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and recover from comfy-cli failures without guesswork, turning confusing errors into a clear next action.

Core Features & Use Cases

  • Error-code triage: Map JSON envelope error codes to the correct fix for local server issues, cloud auth problems, workflow validation failures, and timeouts.
  • Stuck job recovery: Inspect job state, watch live events, and decide whether to wait, resubmit, cancel, or reconnect.
  • Workflow and node debugging: Resolve invalid JSON, missing custom nodes, missing models, and API-format conversion problems.
  • Use case: A render fails mid-run or hangs in queue, and this Skill guides you to the right command and recovery path in seconds.

Quick Start

Use the comfy-debug skill to diagnose the failing comfy-cli command by reading the JSON envelope first and following the most relevant recovery path.

Frequently Asked Questions about comfy-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix comfy-cli workflow errors and stuck jobs?

To fix comfy-cli workflow errors and stuck jobs, read the JSON envelope error code and job status output to map the failure to a specific recovery action like resubmitting, canceling, or reconnecting the job.

Why does my comfy-cli job hang in queue and how do I recover it?

A comfy-cli job hangs in queue due to server outages or disconnected states. Inspect the live job events and JSON envelope status to decide whether to wait, resubmit, cancel, or reconnect the active session.

How do I resolve missing nodes and workflow validation failures in comfy-cli?

Resolve missing nodes and workflow validation failures in comfy-cli by diagnosing invalid JSON structures, identifying missing custom nodes or models, and applying command-level fixes to correct the API-format conversion.

What is the best way to diagnose cloud authentication problems in comfy-cli?

The best way to diagnose cloud authentication problems in comfy-cli is to extract the specific error code from the JSON envelope and follow the mapped recovery path to update credentials or re-authorize the session.

Can I use comfy-cli error triage for local server outages?

Yes, you can use comfy-cli error triage for local server outages by mapping the returned JSON envelope error codes to the correct command-level fixes and retries to restore local connectivity.

What should I do when comfy-cli debugging fails to fix an invalid JSON envelope?

When comfy-cli debugging fails to fix an invalid JSON envelope, check for unhandled workflow validation issues or missing custom nodes that prevent API-format conversion, then manually correct the payload.