comfyui-agent-skill-mie 0.1.3

ComfyUI workflow execution skill for agents with packaged workflows and CLI tooling

ComfyUI Agent Skill

This repository is an Agent Skill folder (Claude Code / Claude.ai / Agent Skills). The only required file is SKILL.md.

• 中文文档: README.zh-CN.md

Status

• Requires a local or trusted self-hosted ComfyUI server (this repo is not a hosted service).
• Not a hosted generation service; this package does not provide a ComfyUI backend.
• This package does not install ComfyUI itself.
• Stable interface: registered workflows only + CLI with structured JSON output.
• Recommended trust model: do not point this at an untrusted public ComfyUI endpoint.
• PyPI package: comfyui-agent-skill-mie (includes comfyui-skill alias).

Registered Workflows

Stable (reviewed configs in assets/workflows/*.config.json):

• z_image_turbo (text-to-image)
• klein_edit (image edit)
• qwen3_tts (text-to-speech)
• ltx-23-t2v (text-to-video)
• ltx-23-i2v (image-to-video)
• ace_step_15_music (music/audio)
• qwen_image_2512_4step (text-to-image, excels at posters and images with embedded text)

Source of truth: the runtime registry is derived from assets/workflows/*.config.json (and the corresponding assets/workflows/*.json workflow files). If this list drifts, trust the configs and python -m comfyui generate --help output.

For Skill Users (Generate / Edit / Video / Audio)

Use this when you want to run registered ComfyUI workflows via the CLI in this repo.

• Primary entry: SKILL.md
• Workflow selection and sizing: references/workflows.md
• Full CLI contract (output paths, async submit/poll, JSON schemas, error codes): references/cli.md
• Prompt enhancement playbooks: references/prompt_enhancement/

Quick Start

Install (Recommended: pipx)

pipx install comfyui-agent-skill-mie
comfyui-agent-skill-mie check
comfyui-agent-skill-mie generate -p "a cute cat sitting on a windowsill at golden hour"
comfyui-skill check
comfyui-skill generate -p "a cute cat sitting on a windowsill at golden hour"

Alternative: uv tool install

uv tool install comfyui-agent-skill-mie
comfyui-agent-skill-mie check
comfyui-agent-skill-mie generate -p "a cute cat sitting on a windowsill at golden hour"
comfyui-skill check
comfyui-skill generate -p "a cute cat sitting on a windowsill at golden hour"

Source mode (for development / maintainers)

uv sync
uv run --no-sync python -m comfyui check
uv run --no-sync python -m comfyui generate -p "a cute cat sitting on a windowsill at golden hour"

Optional short command (after uv sync installs the project):

uv run --no-sync comfyui-skill check
uv run --no-sync comfyui-skill generate -p "a cute cat sitting on a windowsill at golden hour"

From a local wheel (for testing before PyPI publish):

pipx install dist/comfyui_agent_skill_mie-*.whl

Or install from GitHub:

pipx install "git+https://github.com/MieMieeeee/comfyui-agent-skill.git"

In tool-install mode, workflows/references are read from the installed package, while writable data goes to a per-user directory:

• Windows: %APPDATA%\\comfyui-skill
• macOS: ~/Library/Application Support/comfyui-skill
• Linux: $XDG_DATA_HOME/comfyui-skill or ~/.local/share/comfyui-skill

Short alias also available: comfyui-skill

Upgrade

If you installed via pipx:

pipx upgrade comfyui-agent-skill-mie

If you installed via uv tool:

uv tool upgrade comfyui-agent-skill-mie

Troubleshooting

• Run an environment doctor check (server + workflow preflight):
  • comfyui-skill doctor (recommended)
  • comfyui-agent-skill-mie doctor
  • uv run --no-sync python -m comfyui doctor (source mode)
• If the agent/skill runs inside WSL/container/sandbox while ComfyUI runs on the host OS, 127.0.0.1 may point to the runtime itself instead of the host. Try --server http://localhost:8188 or the host machine IP (and optionally persist it via save-server).
• SERVER_UNAVAILABLE: ComfyUI is not reachable at the target URL. Start ComfyUI or re-run with --server http://<ip>:8188.
• PREFLIGHT_MISSING_NODES: install/enable required custom nodes on the ComfyUI server.
• PREFLIGHT_MISSING_MODELS: download required model files on the ComfyUI server.
• NO_OUTPUT: workflow ran but no media could be retrieved; check the workflow output node and server logs/UI.
• For PREFLIGHT_MISSING_NODES, PREFLIGHT_MISSING_MODELS, or NO_OUTPUT, consult the dependency reference: references/workflow_nodes.md.

For Maintainers (Add / Review Workflows)

Maintenance docs are intentionally kept out of SKILL.md to keep the skill instructions user-focused.

• Maintainer entry: MAINTAINER.md
• Detailed workflow registration guide: references/extension.md