Agent skill

Model Registry

by artokun in artokun/comfyui-mcp

Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text…

MITAuto-check passedAI & LLM Engineering

Install Model Registry

skills CLI
$ npx skills add artokun/comfyui-mcp --skill model-registry -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install artokun/comfyui-mcp model-registry --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/artokun/comfyui-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/model-registry .claude/skills/model-registry && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
model-registry
GitHub stars
800
Token cost
~2.1k tokens
SKILL.md length
582 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text…

  • Downloading models with downloadmodel (action:download / action:downloadcivitai)
  • SKILL.md covers Shared VAEs & text encoders…, Flux (see flux-txt2img skill…, WAN 2.x video (see… and LTX-2 19B video (see…, plus 6 more sections
  • Reaches huggingface.co; needs HUGGINGFACE_TOKEN and CIVITAI_API_TOKEN
  • A workflow fails with a missing-model error

What it does

Model Registry is an agent skill from artokun/comfyui-mcp. Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text encoders, and LoRAs. Use when downloading models with downloadmodel (action:"download" / action:"downloadcivitai"), when a workflow fails with a missing-model error, or when setting up a new machine.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Diffusion and image models, MLOps and Fine-tuning. It works with Qwen, Stable Diffusion, ComfyUI and Model Context Protocol. The repository describes itself as: Local-first, agent-native control plane for ComfyUI — MCP server + sidebar agent that generates images, video & audio, authors and runs workflows, and edits your live graph in… The licence is MIT.

When your agent uses it

  • Downloading models with downloadmodel (action:download / action:downloadcivitai)
  • A workflow fails with a missing-model error
  • Setting up a new machine

Example prompts

  • “download”
  • “downloadcivitai”
  • “/model-registry”

Requirements

  • A credential in HUGGINGFACE_TOKEN
  • A credential in CIVITAI_API_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit 6ad6fc0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • huggingface.co

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HUGGINGFACE_TOKEN
    • CIVITAI_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Model Registry loads about 2.1k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 582 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from artokun/comfyui-mcp at commit 6ad6fc0, republished under its MIT licence (© artokun). 582 words, ~2,103 tokens.

Download SKILL.mdSave it as .claude/skills/model-registry/SKILL.md (or your agent's skills folder).
name
model-registry
description
Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text encoders, and LoRAs. Use when downloading models with download_model (action:"download" / action:"download_civitai"), when a workflow fails with a missing-model error, or when setting up a new machine.

Model Registry

One table per family: filename → source URL → target subdir under <COMFYUI>/models/. Use with download_model({ action: "download", url, target_subfolder, filename }). This registry grows with every release. If a model you need is missing, use action:"search" (HuggingFace) or action:"download_civitai" and consider contributing the row.

Quant column (kitchen). Filenames in this registry are mostly bf16 / fp8. NVFP4 and MXFP8 siblings, when a vendor publishes them, are the same stem with nvfp4 / mxfp8 in the name and belong in diffusion_models/ too. kitchen action:"assess" only offers an NVFP4 swap when that sibling is already listed locally — it does not guess a URL from the filename. Blackwell (SM ≥ 10.0) is the GPU that can run NVFP4 / MXFP8 compute.

Conventions

  • HF "resolve" URLs download directly: https://huggingface.co/<repo>/resolve/main/<path>
  • 🔒 = gated repo, needs HUGGINGFACE_TOKEN (accept the license on the HF page first)
  • CivitAI model-page URLs need download_model action:"download_civitai" (resolves version → file); raw civitai.com/api/download/... URLs work with action:"download" + CIVITAI_API_TOKEN
  • Always verify the exact filename a workflow's loader expects. The model-compatibility skill covers which VAE/CLIP pairs with which architecture

Shared VAEs & text encoders (download these once)

FileSourceTarget
ae.safetensors (Flux/Z-Image VAE)huggingface.co/black-forest-labs/FLUX.1-schnell/resolve/main/ae.safetensors (Apache, not gated)vae/
vae-ft-mse-840000-ema-pruned.safetensors (SD1.5 VAE)huggingface.co/stabilityai/sd-vae-ft-mse-original/resolve/main/vae-ft-mse-840000-ema-pruned.safetensorsvae/
clip_l.safetensorshuggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensorstext_encoders/
t5xxl_fp8_e4m3fn.safetensorshuggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp8_e4m3fn.safetensorstext_encoders/
umt5_xxl_fp8_e4m3fn_scaled.safetensors (WAN)huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensorstext_encoders/

Flux (see flux-txt2img skill for workflows)

FileSourceTarget
flux1-dev.safetensors 🔒huggingface.co/black-forest-labs/FLUX.1-devdiffusion_models/
flux1-schnell.safetensorshuggingface.co/black-forest-labs/FLUX.1-schnell/resolve/main/flux1-schnell.safetensorsdiffusion_models/
flux2-vae.safetensors (Flux 2 Klein)huggingface.co/Comfy-Org/flux2-klein — check repo for current pathvae/

WAN 2.x video (see wan-t2v-video / wan-flf-video skills)

Comfy-Org repackages everything: huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged under split_files/.

FilePath in repoTarget
wan2.2_i2v_high_noise_14B_fp8_scaled.safetensorssplit_files/diffusion_models/diffusion_models/
wan2.2_i2v_low_noise_14B_fp8_scaled.safetensorssplit_files/diffusion_models/diffusion_models/
wan_2.1_vae.safetensorssplit_files/vae/vae/
wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensorssplit_files/loras/loras/
wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensorssplit_files/loras/loras/
Magical-morph I2V LoRAs (high/low)huggingface.co/NikolaSigmoid/wan2.2-i2v-loras-magical-morphloras/
SkinMorph Redmond I2V 14Bcivitai.com/models/2210162 (use action:"download_civitai")loras/

LTX-2 19B video (see ltxv2-video skill)

FileSourceTarget
ltx-2-19b-distilled.safetensorshuggingface.co/Lightricks/LTX-2 — check repo for the bf16 distilled pathcheckpoints/
gemma_3_12B_it_fp4_mixed.safetensorshuggingface.co/Comfy-Org LTX repackagetext_encoders/
ltx-2-spatial-upscaler-x2-1.0.safetensorshuggingface.co/Lightricks/LTX-2upscale_models/
Camera-control LoRAs (dolly-left, distilled-384)huggingface.co/Lightricks/LTX-2 LoRA dirloras/

Qwen-Image (see qwen-txt2img / qwen-image-edit skills)

FileSourceTarget
qwen_image_fp8_e4m3fn.safetensorshuggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_fp8_e4m3fn.safetensorsdiffusion_models/
qwen_2.5_vl_7b_fp8_scaled.safetensorssame repo, split_files/text_encoders/text_encoders/
qwen_image_vae.safetensorssame repo, split_files/vae/vae/
qwen_image_edit_2511_bf16.safetensorshuggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI — check repodiffusion_models/
Qwen-Image 2512 Lightning LoRAhuggingface.co/lightx2v/Qwen-Image-2512-Lightningloras/
Qwen-Image-Edit 2511 Lightning LoRAhuggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightningloras/
Qwen-Image 2512 Turbo LoRAhuggingface.co/Wuli-art/Qwen-Image-2512-Turbo-LoRAloras/
Show full SKILL.md (229 more words)Show less

MiniMax H3 video (see minimax-h3-video skill)

Comfy-Org INT8 pack: huggingface.co/Comfy-Org/MiniMax-H3. Local weights are under the MiniMax H3 Community License (territory-restricted). Prefer the filenames the Comfy-Org templates already name.

FileSourceTarget
minimax_h3_fl2va_pruned_int8_convrot.safetensorshuggingface.co/Comfy-Org/MiniMax-H3/resolve/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensorsdiffusion_models/
minimax_h3_ref2va_pruned_int8_convrot.safetensorssame repo, diffusion_models/diffusion_models/
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensorssame repo, text_encoders/text_encoders/
minimax_h3_video_vae_fp16.safetensorssame repo, vae/vae/
minimax_h3_audio_vae_fp32.safetensorssame repo, vae/vae/
minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensorshuggingface.co/lightx2v/Minimax-h3-Turbo/resolve/main/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensorsloras/
minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensorshuggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensorsloras/

Z-Image (see z-image-txt2img skill)

FileSourceTarget
z_image_turbo_bf16.safetensorshuggingface.co/Comfy-Org/z_image_turbo — check repo for split_files pathdiffusion_models/
z_image_base_bf16.safetensorssame family repodiffusion_models/
qwen_3_4b.safetensors (Z-Image text encoder)Comfy-Org repackage, split_files/text_encoders/text_encoders/

SDXL / SD1.5 community checkpoints (CivitAI)

Use download_model({ action: "download_civitai", model_id }). It resolves the latest version and handles auth:

ModelCivitAI
RedCraft RedZ ImageDXcivitai.com/models/958009
Qwen Ultimate Realism v1.1civitai.com/models/2027494
Copax Timelesscivitai.com/models/copaxTimeless (search by name)

Failure modes

  • 404 on an HF resolve URL. The repo restructured. Open the repo page, find the file under "Files", and rebuild the resolve URL.
  • 401/403. Gated repo. Set HUGGINGFACE_TOKEN after accepting the license, or CIVITAI_API_TOKEN for early-access CivitAI files.
  • Wrong dropdown after download. The file landed in the wrong models/ subdir; check the Target column and model-compatibility.
  • Downloads resume on retry (HTTP Range), so re-run the same download_model call after a network drop.

Sources

  • Official: Hugging Face resolve-URL convention https://huggingface.co/<repo>/resolve/main/<path>; kitchen NVFP4/MXFP8 hardware gates in ComfyUI comfy/model_management.py and quant metadata in comfy/quant_ops.py.
  • Empirical: the curated list and Civitai notes are ours, not a vendor catalog.

© artokun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/model-registry of artokun/comfyui-mcp.

Open the folder on GitHubat commit 6ad6fc0

Compare with similar skills

Model Registry next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Model Registry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Model Registry this skillartokun/comfyui-mcp800—~2.1kAutomated safety check: PassMIT
Comfyui Skill OpenclawHuangYuChuh/ComfyUI_Skills_OpenClaw413—~2.7kAutomated safety check: PassApache-2.0
Castguaardvark/guaardvark257—~673Automated safety check: PassMIT
LoRA Space Builderhuggingface/skills11k2 repos~8.4kAutomated safety check: PassApache-2.0
Setupguaardvark/guaardvark257—~1.2kAutomated safety check: PassMIT
Workflow Template BuilderMooshieblob1/MooshieUI207—~640Automated safety check: PassAGPL-3.0

Similar skills

  • Comfyui Skill Openclaw

    HuangYuChuh/ComfyUI_Skills_OpenClaw

    Run registered ComfyUI workflows through the fast comfyui-skill CLI, and use the official local Comfy MCP for live template, node, model, validation, and orchestration capabilities.

    413 GitHub stars~2.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Cast

    guaardvark/guaardvark

    Build consistent characters, environments and props in Guaardvark's Cast Library and train LoRAs for them locally (reference photos → vision bible → sample plan → approved samples → training).

    257 GitHub stars~673 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • LoRA Space Builder

    huggingface/skills

    Official

    Builds and publishes a Gradio demo on Hugging Face Spaces for a LoRA, with the pipeline, UI and settings chosen to match that LoRA's task and model card.

    11k GitHub starsUsed in 2 repos~8.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Setup

    guaardvark/guaardvark

    Connect this agent to a running Guaardvark (self-hosted AI studio) and check what it can do right now.

    257 GitHub stars~1.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Workflow Template Builder

    Mooshieblob1/MooshieUI

    Builds or modifies ComfyUI workflow JSON templates in MooshieUI's Rust backend (src-tauri/src/templates).

    207 GitHub stars~640 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Models

    guaardvark/guaardvark

    Add any Hugging Face image or video model, checkpoint or LoRA to Guaardvark from a URL, list what is installed, and download registry models on request.

    257 GitHub stars~782 tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from artokun/comfyui-mcp

All 42 skills in this repo
  • AI Toolkit Trainer

    artokun/comfyui-mcp

    Train custom LoRAs with ostris AI-Toolkit. An agent skill from artokun/comfyui-mcp.

    800 GitHub stars~2.7k tokensUpdated 4 days ago
    Auto-check passed
  • Anima Base

    artokun/comfyui-mcp

    Anime/illustration text-to-image (ANIMA 1.0, ~2B Cosmos DiT).

    800 GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • Civitai

    artokun/comfyui-mcp

    Discover Civitai models with the BUILT-IN downloadmodel action:"searchcivitai" and install/generate them locally.

    800 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed
  • Color Correction

    artokun/comfyui-mcp

    Diagnose and fix video/image color OBJECTIVELY with the getimage (action:"analyzecolor") tool (scopes/stats such as black/white points, contrast, saturation, clipping, cast) instead of eyeballing a…

    800 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check passed
  • Comfyui Frontend Extensions

    artokun/comfyui-mcp

    Authoring ComfyUI v2 frontend extensions with @comfyorg/extension-api, covering defineNode/defineExtension/defineWidget, shell UI (sidebar tabs, commands, hotkeys), typed events, and handles.

    800 GitHub stars~5.4k tokensUpdated 4 days ago
    Auto-check passed
  • Comfyui Launch Flags

    artokun/comfyui-mcp

    Pick the right ComfyUI startup flags for VRAM, attention, caching, and speed.

    800 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed

Questions about Model Registry

What does Model Registry do?

Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text…. Model Registry is an agent skill from artokun/comfyui-mcp. Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text encoders, and LoRAs.

When should I use Model Registry?

Model Registry fits situations like: downloading models with downloadmodel (action:download / action:downloadcivitai); A workflow fails with a missing-model error; setting up a new machine.

How do I install Model Registry in Claude Code?

Run `npx skills add artokun/comfyui-mcp --skill model-registry -a claude-code`. Or copy the skill folder (plugin/skills/model-registry in artokun/comfyui-mcp) into .claude/skills/model-registry in your project. Claude Code loads it when a task matches its description.

How do I install Model Registry in Codex?

Run `npx skills add artokun/comfyui-mcp --skill model-registry -a codex`. Or copy the skill folder (plugin/skills/model-registry in artokun/comfyui-mcp) into .agents/skills/model-registry in your project. Codex loads it when a task matches its description.

Can I use Model Registry in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add artokun/comfyui-mcp --skill model-registry -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/model-registry, .gemini/skills/model-registry, .github/skills/model-registry and .opencode/skills/model-registry in your project.

What does Model Registry need to run?

Going by SKILL.md and its folder, Model Registry needs credentials named HUGGINGFACE_TOKEN and CIVITAI_API_TOKEN. Our summary lists: A credential in HUGGINGFACE_TOKEN; A credential in CIVITAI_API_TOKEN.

Does Model Registry access the network?

SKILL.md names 1 domain. In commands or code: huggingface.co; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Model Registry safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Model Registry use?

Model Registry is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Model Registry use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Model Registry?

Skills that share tags, products or a category with Model Registry: Comfyui Skill Openclaw (HuangYuChuh/ComfyUI_Skills_OpenClaw, 413 stars), Cast (guaardvark/guaardvark, 257 stars), LoRA Space Builder (huggingface/skills, 11k stars) and Setup (guaardvark/guaardvark, 257 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Model Registry?

artokun (a GitHub user) maintains it in artokun/comfyui-mcp, which has 800 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 5, 2026.

Source: artokun/comfyui-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.