This connects Claude to a running ComfyUI instance so you can queue workflows, poll for completion, and grab the outputs without leaving the terminal. It hits the REST API endpoints for prompt submission, history checking, and file retrieval, with a fallback to JSON export mode when the server isn't running. The polling strategy is straightforward: POST your workflow, then GET the history endpoint every 5 seconds until you see results. It includes validation against your installed nodes and models before queuing anything. Useful when you're orchestrating image or video generation from ComfyUI as part of a larger automated pipeline and don't want to touch the web UI.

skills.sh installs
2.1K
GitHub stars
94
last updated
Jul 14, 2026

Install

$ npx -y skills add mckruz/comfyui-expert --skill comfyui-api --agent claude-code

Installs into .claude/skills of the current project.

Files

ComfyUI API Skill

Connect to ComfyUI's REST API to execute workflows, monitor progress, and retrieve outputs.

Configuration

  • Default URL: http://127.0.0.1:8188
  • Custom URL: Set in project manifest or pass as parameter
  • Timeout: 30s for API calls, no timeout for generation polling

Two Modes

Online Mode (ComfyUI Running)

Full API access. Preferred mode for interactive work.

  1. Test connection: GET /system_stats
  2. Discover capabilities: Use comfyui-inventory skill
  3. Queue workflow: POST /prompt
  4. Poll for results: GET /history/{prompt_id} every 5 seconds
  5. Retrieve outputs: GET /view?filename=...

Offline Mode (No Server)

Export workflow JSON for manual loading in ComfyUI.

  1. Generate workflow JSON following ComfyUI's format
  2. Save to projects/{project}/workflows/{name}.json
  3. Instruct user to drag-drop into ComfyUI

API Operations

Check Server Status

curl http://127.0.0.1:8188/system_stats

Sponsors

Details

Repository
github.com/mckruz/comfyui-expert
Categories
Backend & APIs, Generative Media
First seen
Apr 16, 2026

More from mckruz/comfyui-expert

All 10
1browserbase avatarbrowser-to-apibrowserbase/skillsTurn a website's observable HTTP traffic into a best-effort OpenAPI 3.1 spec by analyzing a `browser-trace` capture. Use when the user wants to discover/extract2Kskills.sh installs
2sickn33 avatarapi-documentation-generatorsickn33/antigravity-awesome-skillsapi documentation generator1.9Kskills.sh installs
3affaan-m avatarmysql-patternsaffaan-m/everything-claude-codemysql patterns1.8Kskills.sh installs
4sickn33 avatardatabase-designsickn33/antigravity-awesome-skillsdatabase design1.7Kskills.sh installs
5affaan-m avatarprisma-patternsaffaan-m/everything-claude-codeprisma patterns1.4Kskills.sh installs
6lobehub avatardrizzlelobehub/lobe-chatdrizzle1.4Kskills.sh installs