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