runpod-comfyui-models

Q: How do I install runpod-comfyui-models?

Run npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-comfyui-models in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/runpod-comfyui-models/ (personal) or .claude/skills/runpod-comfyui-models/ (project).

by runpodAI & Agents

Repair imported ComfyUI workflows with missing or broken model metadata for ComfyUI-RunpodDirect. Accept a workflow JSON or original ComfyUI output PNG, extract and inventory it, and resolve exact model artifacts. Use when a user reports a broken workflow, missing models, or failed model discovery; use companion-clis for generic Hugging Face transfers and runpod-mcp or runpodctl for Pod lifecycle.

Installs: 465
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-comfyui-models

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads runpod-comfyui-models automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Repair a ComfyUI workflow for RunpodDirect

Return a new UI workflow JSON containing trustworthy properties.models records that ComfyUI-RunpodDirect can consume — never substitute a plausible model merely to make the graph queue. Never edit, replace, or overwrite the supplied JSON or PNG. For every recoverable UI workflow, hand off exactly one new <workflow-stem>.repaired.json — even when resolution is incomplete, ambiguous, gated, or interrupted.

Terms — workflow vs prompt vs metadata record

Term	What it is	Role here
UI workflow JSON	The graph the ComfyUI frontend exports/imports: nodes, links, widget values, `properties`	the only JSON this skill annotates
API `prompt` JSON	The execution format POSTed to `/prompt`, keyed by node id	inventory evidence only — never annotate it
`properties.models` record	A loader node's model metadata entry (`name`, `url`, `directory`, optional `hash`)	what a repair adds or fixes

Annotation targets the UI format only; the API prompt has no portable model-metadata contract.

Intake

No artifact yet → ask exactly once: “Please attach the workflow JSON or the original ComfyUI output PNG.” (Screenshots and re-encoded images usually lose the workflow.)
Artifact present → no further intake questions: extract when needed, inventory, resolve, write the repaired copy, return it.
No recoverable UI workflow (API-only JSON, stripped PNG) → that is the single blocker; request the original UI workflow or PNG.

Decide the path

Observed state	Action
Every model requirement has complete metadata with no reported issues	Preserve its content unchanged, write the one new final JSON, and report that no records were added. Verify or harden only when explicitly requested or when a live failure provides evidence of a problem.
Exact filename but no trustworthy URL	Inventory node context, then resolve candidates from original template sources, ComfyUI-Manager, Hugging Face, or Civitai.
Generic filename or several credible matches	Do not apply ambiguous metadata or download. Publish the partial workflow, report its path, then show the candidates and ask the user to choose.
Gated or license-restricted artifact	Publish the partial workflow first, then stop before authentication/download until access and license acceptance are confirmed.
RunpodDirect routes unavailable	Produce the repaired workflow; keep its working manifest temporary and recommend or diagnose RunpodDirect only when the environment warrants it.

The references

Reference	The one question it answers
reference/resolution.md	Which exact artifact is this model? Evidence, source order, confidence policy.
reference/metadata.md	How is approved metadata written into the workflow? Patch rules, unsafe-URL handling, the exact handoff lines.
reference/runpoddirect.md	Is the live extension there, and how is it driven safely? Feature detection, download authorization, URL/redirect/secret safety.

Low-friction contract

inspect / check → read-only work.
find / repair / fix → also write the new repaired copy.
download / make it work on this Pod → also download verified public unchanged tuples.
run / test end to end → plus one controlled smoke test.

Never reconfirm a step the opening intent already covered. Ask once, and only for a material decision: ambiguity, gated access or a license, an install or restart, a cost/storage choice, or an action beyond the opening request. If no decision remains, finish the authorized work and report once — an optional next step is not a question.

Workflow

Extract (PNG input only): python3 -B extract_png_workflow.py pulls the embedded UI workflow from a ComfyUI output PNG into the task's temporary directory.
Inventory: python3 -B inventory_workflow_models.py lists every loader selection, subgraphs included — evidence, never an identity decision.
Resolve each identity per reference/resolution.md, stopping at the first verified publisher artifact; keep the review manifest temporary.
Apply: python3 -B apply_model_metadata.py --allow-unresolved writes the new workflow every time, even when nothing could be resolved; patch rules, unsafe-URL handling, and the publish contract live in reference/metadata.md.
Live checks (only within the request's scope): one batched read-only probe of the pod's RunpodDirect routes — curl is fine, batched rather than a visible sequence — then downloads only as authorized, per reference/runpoddirect.md.

Consult --help only after a usage error. Working state (extracted JSON, inventory, manifest) lives in one task-specific temporary directory, deleted after the repaired JSON validates; the repaired JSON is the only persistent artifact. Hand off in plain language — the exact lines are in reference/metadata.md.

Routing onward

The task is actually…	Send it to
Provision a pod for the workflow	golden path 02 (index: golden paths), then runpod-mcp or runpodctl
Model repo and file already known exactly	`companion-clis`
A template pod won't boot, or models are missing on a template pod	`runpod-templates`
Install or understand RunpodDirect itself	reference/runpoddirect.md

FAQ

What does the runpod-comfyui-models skill do?

How do I install runpod-comfyui-models?

Run npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-comfyui-models in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/runpod-comfyui-models/ (personal) or .claude/skills/runpod-comfyui-models/ (project).

Which AI agents can use runpod-comfyui-models?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is runpod-comfyui-models safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains runpod-comfyui-models?

It is published by runpod in runpod/runpod-plugins-official. It has 465 recorded installs.

Source

runpod/runpod-plugins-official $View on skills.sh

Works with

Claude CodeCodexCursorGitHub CopilotGemini CLIWindsurfClineOpenCodeRoo CodeGooseAmpKiro

Files 21 · 193.6 KB

SKILL.md6.3 KB
evals/always-output-workflow.eval.md2.5 KB
evals/ambiguous-filename.eval.md1.5 KB
evals/api-inventory-only.eval.md1.2 KB
evals/gated-model.eval.md1.7 KB
evals/mixed-resolved-ambiguous-output.eval.md1.3 KB
evals/nontechnical-handoff.eval.md1.4 KB
evals/png-output-extraction.eval.md1.8 KB
evals/repair-and-handoff.eval.md3.0 KB
evals/runpoddirect-required-handoff.eval.md1.6 KB
evals/support-intake.eval.md1.5 KB
evals/template-recommendation.eval.md1.6 KB
evals/unsafe-download-url.eval.md2.1 KB
reference/metadata.md14.2 KB
reference/resolution.md7.3 KB
reference/runpoddirect.md9.4 KB
scripts/apply_model_metadata.py21.9 KB
scripts/extract_png_workflow.py15.1 KB
scripts/inventory_workflow_models.py30.9 KB
tests/test_model_metadata_scripts.py51.4 KB
tests/test_png_workflow_extractor.py15.9 KB