comfyui-discover
Inspect a live ComfyUI server for version, hardware, feature flags, queue depth, installed node schemas, model categories, and model filenames before selecting or validating a workflow.
SKILL.mdskills/comfyui-discover/SKILL.md
GitHubComfyUI Discover
Read
../../references/COMFYUI_OPERATIONS.md../../references/COMFYUI_NATIVE_API.md
Procedure
- In Pi, begin with
story_comfy action=server-info. Do this before any shell, filesystem, or guessed-path attempt to locate ComfyUI. - If the Story-Film project is a child of Pi's current working directory, pass
project=<project-root>to project-scopedstory_comfyactions. Project creation does not change Pi's working directory. - Use the user-supplied server URL when present. Otherwise use the configured environment URL or loopback default.
- Probe the server before doing generation work.
- Read system stats and features.
- Query exact node classes or filtered node catalog only when the task needs them. In Pi use
story_comfy action=node-searchoraction=node-info. - Before building a workflow, run the bundled workflow catalog. In Pi use
story_comfy action=workflow-catalog. It reads only Story-Film'scomfyui_workflows/directory: built-ins pluscustom/<task>/<model>/. - Query model categories and filenames only when model availability matters. In Pi use
story_comfy action=model-inventoryandaction=model-search. The server registries include model roots registered throughextra_model_paths.yaml. - Use
/object_infothrough Story-Film's managed/native control layer for node schemas. Its node input schema is underinput.requiredandinput.optional. Do not treat an empty result from an incorrectly parsedinputsfield as evidence that models are missing. - Save a project snapshot to
04_generation/comfyui/server_snapshot.jsonwhen reproducibility or later diagnosis benefits.
Bundled commands:
python scripts/comfyui_control.py probe
python scripts/comfyui_control.py nodes --query <term>
python scripts/comfyui_control.py models
python scripts/workflow_catalog.py catalog PROJECT --query <term>
python scripts/comfyui_control.py models --folder <category>
Do not
- use Bash,
find,ls,which,locate, directory globbing, home-directory scans, or guessed personal paths to locate ComfyUI or model files; usestory_comfyand the live server registry instead - infer that ComfyUI is absent from a failed
cd, a missing guessed directory, or a failed filesystem search - infer that models are absent from an empty guessed
checkpoints,vae,loras,unet, ordiffusion_modelsdirectory - invoke managed comfy-cli discovery commands directly through Bash when
story_comfycan perform the operation - write one-off model inventory scripts or raw
/modelscurl loops whenmodel_inventory.pyis available; use the bundled inventory tool for Story-Film model selection - search
/workflow_templates,/userdata, ComfyUI saved workflows, project workflow folders, or arbitrary external paths for selectable workflows; custom workflow JSON must be copied intocomfyui_workflows/custom/<task>/<model>/ - write one-off
/object_infoor/promptparsers/loops when the bundled controller already owns live validation and execution - infer that models are absent because they are outside the ComfyUI application directory
- create mock media or download substitute models when discovery is incomplete
- assume a custom node exists from an online workflow
- treat a stale saved snapshot as current capability data
- guess model filenames from model family names
Done
The next step has live evidence for the server, required node classes, and relevant models instead of assumptions.