Getting Started

Set up ComfyUI Skills in under 5 minutes.

Clone the project, install the CLI, and start generating images from any AI agent.

Prerequisites

What you need

  • Python 3.10+
  • A running ComfyUI server (default: http://127.0.0.1:8188)
  • pipx or pip for installing the CLI tool

Step 1

Clone the project

Choose the path that matches your agent platform:

# For OpenClaw
cd ~/.openclaw/workspace/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill-openclaw
cd comfyui-skill-openclaw

# For Claude Code
cd ~/.claude/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill

# For Codex
cd ~/.codex/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill

Then copy the example config:

cp config.example.json config.json

Step 2

Install the CLI

pipx install comfyui-skill-cli

Or with pip:

pip install comfyui-skill-cli

If you already installed it, upgrade with:

# If installed with pipx
pipx upgrade comfyui-skill-cli

# If installed with pip
python3 -m pip install -U comfyui-skill-cli

Step 3

Verify the setup

# Check server connectivity
comfyui-skill server status

# List available workflows
comfyui-skill list

The CLI reads config.json and data/ from the current directory. All commands support --json for structured output.

Step 4

Import your first workflow

# Import a workflow JSON (auto-detects format, generates schema)
comfyui-skill workflow import /absolute/path/to/my-workflow.json

# Check and install dependencies
comfyui-skill deps check local/my-workflow
comfyui-skill deps install local/my-workflow --all

# Run it
comfyui-skill run local/my-workflow --args '{"prompt": "a white cat"}'

For manual CLI imports, prefer passing the workflow JSON as an absolute path. This avoids path ambiguity and keeps the storage model simple.

Example: /Users/yourname/Downloads/my-workflow.json

The formal storage layout used by the CLI, Web UI, and agent-driven imports is: data/<server_id>/<workflow_id>/workflow.json plus schema.json and history/.

Optional

Web UI

A local web interface is available for visual workflow management. Not required for agent usage — the CLI covers all functionality.

# macOS / Linux
./ui/run_ui.sh

# Windows
ui\run_ui.bat

The script automatically creates a .venv, installs dependencies, and starts the server. Visit http://localhost:18189 to manage workflows visually.

Next Steps

Keep exploring