Agent skill

Importing Subgraphs

by Comfy-Org in Comfy-Org/workflow_templates

Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository.

MITAuto-check passedAI & LLM Engineering

Install Importing Subgraphs

skills CLI
$ npx skills add Comfy-Org/workflow_templates --skill importing-subgraphs -a claude-code

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

GitHub CLI
$ gh skill install Comfy-Org/workflow_templates importing-subgraphs --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/Comfy-Org/workflow_templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/importing-subgraphs .claude/skills/importing-subgraphs && 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
importing-subgraphs
GitHub stars
1.3k
Token cost
~1.5k tokens
SKILL.md length
512 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository.

  • Works in 6 steps: Obtain the Blueprint JSON → Add a Thumbnail (Optional) → Embed Model Metadata (Recommended) → …
  • Asked to: import a subgraph
  • SKILL.md covers Rules, Step 1 — Obtain the Blueprint…, Step 2 — Add a Thumbnail… and Step 3 — Embed Model Metadata…, plus 5 more sections
  • Calls python; reaches huggingface.co

What it does

Importing Subgraphs is an agent skill from Comfy-Org/workflow_templates. Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository. Handles placing blueprint JSON files, adding thumbnails, running the import/sync pipeline, and validating results. Use when asked to: import a subgraph, add a blueprint, register a blueprint, add a subgraph blueprint, import a subgraph blueprint, contribute a subgraph, add a new node component, publish a blueprint, upload a subgraph, create a blueprint, onboard a subgraph, add a reusable node. Triggers on: import subgraph…

Its SKILL.md is about 1.5k 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. It works with ComfyUI. The repository describes itself as: ComfyUI template workflows. The licence is MIT.

When your agent uses it

  • Asked to: import a subgraph
  • Add a blueprint
  • Register a blueprint
  • Add a subgraph blueprint

Example prompts

  • “Use the importing-subgraphs skill to import and registers subgraph blueprints into the ComfyUI workflowtemplates repository”
  • “/importing-subgraphs”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Obtain the Blueprint JSON
  2. Add a Thumbnail (Optional)
  3. Embed Model Metadata (Recommended)
  4. Sync to Packages
  5. Validate
  6. Bump Version

What it can do on your machine

Read from SKILL.md and the folder at commit 8be1f8c. 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

    Shell commands in SKILL.md call:

    • python

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Importing Subgraphs loads about 1.5k tokens when it runs. Until then it costs about 156 tokens; SKILL.md has 512 words of instructions outside code blocks.

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

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 Comfy-Org/workflow_templates at commit 8be1f8c, republished under its MIT licence (© Comfy-Org). 512 words, ~1,474 tokens.

Download SKILL.mdSave it as .claude/skills/importing-subgraphs/SKILL.md (or your agent's skills folder).
name
importing-subgraphs
description
Imports and registers subgraph blueprints into the ComfyUI workflow_templates repository. Handles placing blueprint JSON files, adding thumbnails, running the import/sync pipeline, and validating results. Use when asked to: import a subgraph, add a blueprint, register a blueprint, add a subgraph blueprint, import a subgraph blueprint, contribute a subgraph, add a new node component, publish a blueprint, upload a subgraph, create a blueprint, onboard a subgraph, add a reusable node. Triggers on: import subgraph, add blueprint, subgraph blueprint, new blueprint, register blueprint, blueprint import.

Importing Subgraph Blueprints

Subgraph blueprints are pre-built ComfyUI node components stored in blueprints/ and shipped via the comfyui-subgraph-blueprints package.

Rules

  • Never modify scripts, build tooling, or CI configuration.
  • Always validate after changes (Step 4).
  • Blueprint filenames must be snake_case — the import script handles renaming automatically.
  • Use double-quotes " in all JSON files.
  • Blueprint JSON must contain a definitions.subgraphs array with at least one entry.

Step 1 — Obtain the Blueprint JSON

Two sources:

Option A — Import from an external directory:

bash
python scripts/blueprints/import_blueprints.py --source /path/to/external/blueprints/

The script copies all *.json files (skipping index*.json) into blueprints/, renames them to snake_case, regenerates blueprints/index.json, and updates blueprints_bundles.json.

Option B — Manual placement (single file):

  1. Export the subgraph from ComfyUI (Save → Export workflow JSON).
  2. Copy the .json file to blueprints/ with a snake_case name, e.g. my_blueprint.json.
  3. Run the import script (no --source needed) to normalize and regenerate index + bundles:
    bash
    python scripts/blueprints/import_blueprints.py
Required blueprint JSON structure

The file must contain definitions.subgraphs[0] with these fields:

FieldRequired
nameyes — display name shown in the node palette
inputsyes — exposed input slots
outputsyes — exposed output slots
nodesyes — internal ComfyUI nodes

Step 2 — Add a Thumbnail (Optional)

Thumbnail files live in blueprints/ and follow the naming pattern:

{blueprint_name}-1.webp     # primary (required for thumbnail display)
{blueprint_name}-2.webp     # secondary (optional, for compare/hover effects)
  • Convert to webp format (lossy ~65% quality).
  • The import script sets "mediaSubtype": "webp" in index.json automatically.

For every model-loading node inside definitions.subgraphs[0].nodes (e.g. UNETLoader, VAELoader, CLIPLoader), add a "models" array to the node's "properties":

json
"properties": {
  "Node name for S&R": "UNETLoader",
  "cnr_id": "comfy-core",
  "ver": "0.3.40",
  "models": [
    {
      "name": "flux1-dev.safetensors",
      "url": "https://huggingface.co/.../resolve/main/flux1-dev.safetensors?download=true",
      "hash": "<sha256>",
      "hash_type": "SHA256",
      "directory": "diffusion_models"
    }
  ]
}

The name field must exactly match the corresponding widgets_values entry. The import script surfaces model names automatically in index.json (limited to first 5).


Step 4 — Sync to Packages

After import_blueprints.py succeeds, push assets into the package directory and regenerate the manifest:

bash
python scripts/sync/sync_blueprints.py

This writes packages/core/src/comfyui_workflow_templates_core/blueprints_manifest.json and copies all blueprint files into packages/blueprints/src/comfyui_subgraph_blueprints/blueprints/.


Show full SKILL.md (227 more words)Show less

Step 5 — Validate

bash
python scripts/validate/validate_blueprints.py

Checks:

  • JSON syntax for all blueprint files
  • index.json against index.schema.json
  • Blueprint structure (definitions.subgraphs present with required fields)
  • blueprints_bundles.json consistency with files on disk

Fix all errors before continuing. CI will fail if bundles or manifests are out of sync.


Step 6 — Bump Version

Increment the version field in the root pyproject.toml. CI uses this to detect changes and publishes affected packages to PyPI.


Common Requests

User saysAgent action
"Import blueprints from this folder"Step 1 Option A, then Steps 4–6
"Add this subgraph JSON as a blueprint"Step 1 Option B, then Steps 4–6
"Add a thumbnail for blueprint X"Step 2 only, then re-run Step 4
"Embed model info into this blueprint"Step 3 only, then re-run Steps 1, 4, 5
"Validate blueprints"Step 5 only
"Sync blueprints to packages"Step 4 only
"Why does the index not have my blueprint?"Check filename is snake_case, re-run import_blueprints.py

File Quick-Reference

File / DirPurpose
blueprints/Blueprint JSON files and thumbnail images
blueprints/index.jsonGenerated metadata index (do not edit manually)
blueprints/index.schema.jsonJSON schema for index validation
blueprints_bundles.jsonGenerated list of all blueprint IDs
scripts/blueprints/import_blueprints.pyNormalize filenames, generate index.json and bundles
scripts/sync/sync_blueprints.pyGenerate manifest, copy assets to package directories
scripts/validate/validate_blueprints.pyValidate all blueprints and consistency checks
pyproject.tomlRoot package version (bump before PR)
packages/blueprints/comfyui-subgraph-blueprints package (generated assets)
packages/core/.../blueprints_manifest.jsonGenerated manifest consumed by the Python API

© Comfy-Org, 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 .claude/skills/importing-subgraphs of Comfy-Org/workflow_templates.

Open the folder on GitHubat commit 8be1f8c

Compare with similar skills

Importing Subgraphs 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.

Importing Subgraphs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Importing Subgraphs this skillComfy-Org/workflow_templates1.3k—~1.5kAutomated safety check: PassMIT
Comfyui AnimatoolShiroEirin/comfyui-good-anima478—~4.6kAutomated safety check: PassGPL-3.0
Comfyui Agent Skill MieMieMieeeee/comfyui-agent-skill116—~3.9kAutomated safety check: PassApache-2.0
Comfyui Node Addernixified-ai/flake841—~806Automated safety check: PassAGPL-3.0
Headroommomori777/Artemis377—~562Automated safety check: PassMIT
Comfyui AnimatoolShiroEirin/comfyui-good-anima478—~3.4kAutomated safety check: PassGPL-3.0

Similar skills

  • Comfyui Animatool

    ShiroEirin/comfyui-good-anima

    Route ALL Anima image generation: validate Danbooru hard anchors, form visual brief, assemble English prompts and args, then load comfyui-manager for workflow execution.

    478 GitHub stars~4.6k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Comfyui Agent Skill Mie

    MieMieeeee/comfyui-agent-skill

    Agent skill for running registered ComfyUI workflows through a stable CLI, and for importing a user's own ComfyUI workflow into their private registry after review.

    116 GitHub stars~3.9k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Comfyui Node Adder

    nixified-ai/flake

    Adds new custom nodes to the ComfyUI Nix project, including npins fetching, dependency resolution in package.nix, disabling impure pip installs, and verifying the Nix build.

    841 GitHub stars~806 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Headroom

    momori777/Artemis

    SmartCrusher + CCR context compression — crunch large JSON arrays, tool outputs, and search results to save tokens.

    377 GitHub stars~562 tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Comfyui Animatool

    ShiroEirin/comfyui-good-anima

    A skill your agent uses for Anima / ComfyUI-AnimaTool image generation.

    478 GitHub stars~3.4k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Add Comfy Workflow Template

    peteromallet/VibeComfy

    Add a durable VibeComfy ready workflow/template from a ComfyUI source workflow.

    150 GitHub stars~700 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed

More from Comfy-Org/workflow_templates

All 10 skills in this repo
  • Editing Site Content

    Comfy-Org/workflow_templates

    Edits, updates, rewrites, or adds content on the ComfyUI template site pages.

    1.3k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Managing Bundles

    Comfy-Org/workflow_templates

    Manages template bundles, categories, and ordering in the ComfyUI template repository.

    1.3k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Managing MCP Index

    Comfy-Org/workflow_templates

    Builds and maintains templates/index.mcp.json for Comfy Cloud MCP tools.

    1.3k GitHub stars~1.9k tokensUpdated today
    Auto-check: notes
  • Managing Releases

    Comfy-Org/workflow_templates

    Manages releases for this repository: how version bumps, PyPI publishing, and GitHub releases work.

    1.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Managing Templates

    Comfy-Org/workflow_templates

    Manages ComfyUI workflow templates end-to-end: add new templates and rename existing ones (files, index metadata, bundles, i18n, package sync).

    1.3k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Managing Thumbnails

    Comfy-Org/workflow_templates

    Manages thumbnail and preview images for ComfyUI workflow templates.

    1.3k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Questions about Importing Subgraphs

What does Importing Subgraphs do?

Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository. Importing Subgraphs is an agent skill from Comfy-Org/workflow_templates. Imports and registers subgraph blueprints into the ComfyUI workflowtemplates repository.

When should I use Importing Subgraphs?

Importing Subgraphs fits situations like: asked to: import a subgraph; add a blueprint; register a blueprint; add a subgraph blueprint.

How do I install Importing Subgraphs in Claude Code?

Run `npx skills add Comfy-Org/workflow_templates --skill importing-subgraphs -a claude-code`. Or copy the skill folder (.claude/skills/importing-subgraphs in Comfy-Org/workflow_templates) into .claude/skills/importing-subgraphs in your project. Claude Code loads it when a task matches its description.

How do I install Importing Subgraphs in Codex?

Run `npx skills add Comfy-Org/workflow_templates --skill importing-subgraphs -a codex`. Or copy the skill folder (.claude/skills/importing-subgraphs in Comfy-Org/workflow_templates) into .agents/skills/importing-subgraphs in your project. Codex loads it when a task matches its description.

Can I use Importing Subgraphs 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 Comfy-Org/workflow_templates --skill importing-subgraphs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/importing-subgraphs, .gemini/skills/importing-subgraphs, .github/skills/importing-subgraphs and .opencode/skills/importing-subgraphs in your project.

What does Importing Subgraphs need to run?

Going by SKILL.md and its folder, Importing Subgraphs needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Importing Subgraphs 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 Importing Subgraphs 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 Importing Subgraphs use?

Importing Subgraphs 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 Importing Subgraphs use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Importing Subgraphs?

Skills that share tags, products or a category with Importing Subgraphs: Comfyui Animatool (ShiroEirin/comfyui-good-anima, 478 stars), Comfyui Agent Skill Mie (MieMieeeee/comfyui-agent-skill, 116 stars), Comfyui Node Adder (nixified-ai/flake, 841 stars) and Headroom (momori777/Artemis, 377 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Importing Subgraphs?

Comfy-Org (a GitHub organization) maintains it in Comfy-Org/workflow_templates, which has 1,260 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.

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