Why comfyui-skill?

Install

pipx install comfyui-skill-cli

Or with pip:

pip install comfyui-skill-cli

Update

pipx upgrade comfyui-skill-cli

Development Mode

git clone https://github.com/HuangYuChuh/ComfyUI_Skill_CLI.git
cd ComfyUI_Skill_CLI
pipx install -e .

Quick Start

# 1. Go to your ComfyUI Skills project directory
cd /path/to/your-skills-project

# 2. Check server status
comfyui-skill server status

# 3. List available workflows
comfyui-skill list

# 4. Execute a workflow
comfyui-skill run local/txt2img --args '{"prompt": "a white cat"}'

Every command supports --json for structured output.

ID Convention

Workflows are addressed as <server_id>/<workflow_id>:

comfyui-skill run local/txt2img          # explicit server
comfyui-skill run txt2img                # uses default server
comfyui-skill run txt2img -s my_server   # override with --server flag

Commands

Workflow Discovery & Execution

Queue & Resource Management

Node & Model Discovery

Workflow Management

Server Management

Dependency Management

Configuration & History

Global Options

Output Modes

Common Management Tasks

Upload to a specific ComfyUI server

# Use a configured server; --server may appear after the file path
comfyui-skill upload ./input.png --server remote

# Use a URL directly; no config.json is required for this form
comfyui-skill upload ./input.png --url http://remote:8188

--server and --url are mutually exclusive. The global form remains supported too: comfyui-skill --server remote upload ./input.png.

Inspect models on a server

comfyui-skill models list
comfyui-skill models list checkpoints
comfyui-skill models list loras

Use this when you need to confirm model names before wiring them into a workflow or schema.

Manage multiple workflows

# Preview workflows available in ComfyUI server userdata
comfyui-skill workflow import --from-server --preview

# Import matching workflows from the server
comfyui-skill workflow import --from-server --name sdxl

# Temporarily disable or re-enable a workflow
comfyui-skill workflow disable local/old-flow
comfyui-skill workflow enable local/old-flow

# Remove a workflow you no longer want to expose
comfyui-skill workflow delete local/old-flow

Move workflow bundles between machines

comfyui-skill config export --output ./bundle.json --portable-only
comfyui-skill config import ./bundle.json --dry-run
comfyui-skill config import ./bundle.json --apply-environment

Use this when you want to migrate many workflows at once instead of re-importing them manually.

Check models and dependencies before running

comfyui-skill deps check local/txt2img
comfyui-skill deps install local/txt2img --models
comfyui-skill deps install local/txt2img --all

For AI Agents

This CLI is designed to be called from SKILL.md definitions. A typical agent workflow:

comfyui-skill server status --json                    # 1. verify server
comfyui-skill list --json                             # 2. discover workflows
comfyui-skill info local/txt2img --json               # 3. check parameters
comfyui-skill run local/txt2img --args '{...}' --json # 4. execute

Workflow chaining (multi-step pipelines)

# Run first workflow
comfyui-skill run local/txt2img --args '{"prompt": "a cat"}' --json

# Chain output into next workflow
comfyui-skill upload --from-output <prompt_id> --json
comfyui-skill run local/upscale --args '{"image": "<uploaded_name>"}' --json

Import and validate

comfyui-skill workflow import ./workflow.json --check-deps --json
comfyui-skill deps install local/my-workflow --all --json

Contributing

Contributions are welcome! Please read the Contributing Guide in the main repository for design principles and PR workflow.

Resources

• ComfyUI Skills OpenClaw — Main skills repository
• ComfyUI — The backend this CLI orchestrates
• Typer — CLI framework used by this project

Built with Typer, the same framework as comfy-cli. Designed to be integrated as a comfy skills subcommand in the future.