Agent skill

Run Comfy Workflow

by peteromallet in peteromallet/VibeComfy

Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs.

MITAuto-check passedTesting & QA

Install Run Comfy Workflow

skills CLI
$ npx skills add peteromallet/VibeComfy --skill run-comfy-workflow -a claude-code

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

GitHub CLI
$ gh skill install peteromallet/VibeComfy run-comfy-workflow --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/peteromallet/VibeComfy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/agent-skill/skills/run-comfy-workflow .claude/skills/run-comfy-workflow && 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
run-comfy-workflow
GitHub stars
150
Token cost
~1.8k tokens
SKILL.md length
680 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs.

  • The user asks to run
  • SKILL.md covers Preflight, Embedded Runtime, Canonical dependency repair loop and Existing ComfyUI Server, plus 2 more sections
  • Calls python, uv and pytest
  • Use a local/remote ComfyUI runtime

What it does

Run Comfy Workflow is an agent skill from peteromallet/VibeComfy. Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs. Use when the user asks to run, queue, execute, generate, render, smoke test, use a local/remote ComfyUI runtime, or run on RunPod.

Its SKILL.md is about 1.8k 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 Testing & QA, covering Diffusion and image models and QA and bug reports. It works with ComfyUI. The licence is MIT.

When your agent uses it

  • The user asks to run
  • Use a local/remote ComfyUI runtime

Example prompts

  • “/run-comfy-workflow”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b1429c6. 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
    • uv
    • pytest

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

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    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

Run Comfy Workflow loads about 1.8k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 680 words of instructions outside code blocks.

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

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 peteromallet/VibeComfy at commit b1429c6, republished under its MIT licence (© peteromallet). 680 words, ~1,750 tokens.

Download SKILL.mdSave it as .claude/skills/run-comfy-workflow/SKILL.md (or your agent's skills folder).
name
run-comfy-workflow
description
Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs. Use when the user asks to run, queue, execute, generate, render, smoke test, use a local/remote ComfyUI runtime, or run on RunPod.

Run Comfy Workflow

Use this for execution. If the graph must change first, use edit-comfy-workflow. If ComfyUI or paths are not configured, use vibecomfy-setup. If a run fails, use debug-comfy-workflow.

Preflight

bash
vibecomfy inspect <workflow>
vibecomfy validate <workflow>
vibecomfy doctor <workflow> --json

For raw JSON or a selected Hivemind revision, use the one importer first; run the resulting local bundle:

bash
vibecomfy import <workflow.json-or-hivemind-reference>
vibecomfy validate workflows/<name> --json
vibecomfy run workflows/<name> --runtime embedded

Embedded Runtime

@python_node and source capsules execute through the existing ordinary vibecomfy.exec node. They run in process with the selected ComfyUI worker's files, imports, network, credentials, and GPU privileges; there is no reliable timeout or sandbox. Snapshot capsules are materialized in a digest-qualified cache, while installed entrypoints use their normal package namespace. A worker dependency check happens before source import.

Use embedded when local ComfyUI is discoverable in the active environment:

bash
vibecomfy run <workflow.py> --runtime embedded
vibecomfy run image/z_image --ready --runtime embedded

Prompt/seed/steps CLI overrides only work when the workflow exposes matching public inputs:

bash
vibecomfy run image/z_image --ready --runtime embedded --prompt "..." --seed 7 --steps 20

Use dependency helpers only when the user wants VibeComfy to prepare local runtime assets:

bash
vibecomfy run <workflow.py> --runtime embedded --ensure-packs --ensure-models

--ensure-packs is embedded-only.

Canonical dependency repair loop

For a local Python workflow, run reads the authored MODELS / ModelAsset and READY_METADATA.requirements.custom_node_refs surfaces before compilation. Missing model URLs, repository URLs, unsafe destinations, unsupported dynamic metadata, and root or nested node classes that are not core, explicitly listed in a ref's classes/class_set, or covered by one unambiguous local pack catalog are reported together. The run stops with: "Run blocked: dependencies unresolved. Nothing downloaded, installed, restarted, compiled, or queued." Common literal placeholders are written back to the same workflow.py; rerunning is idempotent.

python
from vibecomfy.templates import ModelAsset, ReadyMetadata

MODELS = {
    "denoiser": ModelAsset(
        filename="denoiser.safetensors",
        url="https://host.example/models/denoiser.safetensors",
        subdir="diffusion_models",
        hf_revision="<revision>",       # optional
        sha256="<64-hex-digest>",        # optional
    ),
}
READY_METADATA = ReadyMetadata.build(
    capability="image",
    requirements={"custom_node_refs": [{
        "slug": "example-pack", "source": "git",
        "url": "https://host.example/example-pack.git",
        "version": "<tag-or-branch>",  # optional; commit is also supported
        "classes": ["ExampleNode"],
    }]},
)

A model URL resolves the current bytes at that URL by default and records the effective URL, observed SHA-256, size, and file-stat evidence in the local verification receipt. A supplied checksum/revision is honored. A node URL resolves the repository's default branch by default; a supplied version/tag/ branch is checked out, and a supplied commit is verified exactly. The existing custom_nodes.lock is reused when its URL and optional selectors match, so a repeat does not silently move a workflow to a new revision. Change the URL or request an explicit refresh to start a new resolution.

After the report is clear, the existing preparation and runtime path performs the download/install, preserves bounded download concurrency, and keeps the normal warm-session behavior. Inspect preparation receipts under out/preparations/ when troubleshooting; do not infer a provider from a model filename or node class. Remote --server-url runs remain non-mutating, and RunPod/GPU validation plus Astrid project integration are separate follow-on routes.

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

Existing ComfyUI Server

Use this when the user already has ComfyUI running locally or remotely:

bash
vibecomfy run <workflow.py> --runtime server --server-url http://127.0.0.1:8188
vibecomfy run image/z_image --ready --runtime server --server-url http://127.0.0.1:8188

Python-format workflows work against an existing server. VibeComfy imports the workflow's build(), compiles the VibeWorkflow to API JSON, and queues that JSON to the server.

The external server must already have the required custom nodes and models unless the user separately stages them into that server's environment. Do not use --ensure-packs with server runtime. --ensure-models can only prepare the local/shared model path VibeComfy can see.

For a VibeComfy-managed local HTTP server, omit --server-url:

bash
vibecomfy run <workflow.py> --runtime server

--runtime auto attaches to an active default session when one exists; otherwise it falls back to embedded execution.

RunPod

Use RunPod when requested or when local execution is unavailable and a GPU run is necessary. The acceptance script is a retired fail-closed placeholder; it exits before provisioning and cannot establish an end-to-end result. The validation and matrix commands are live remote operations:

bash
python scripts/runpod_acceptance.py  # refusal only; no live acceptance
python scripts/runpod_validate.py   # one remote smoke
VIBECOMFY_MATRIX_SCOPE=<family> uv run python scripts/runpod_corpus_matrix.py  # remote matrix
pytest --runpod -m runpod tests/smoke/test_layer2_runpod_ops.py

Use runpod_validate.py for the cheapest live launch/runtime sanity check. Use runpod_corpus_matrix.py only for model-family or corpus coverage after the smoke is green, starting with the smallest scope that answers the question. These are GPU/network checks and do not replace the no-GPU structural gates. Use vibecomfy import followed by validate and doctor for source onboarding; use the offline approved-record transport to check record bytes and queue payloads.

Report Outputs

Runs return a RunResult with run_id, prompt_id, outputs, metadata_path, and log_path. The same fields are persisted under out/runs/<run_id>/.

Report:

  • generated files under the run directory
  • out/runs/<run_id>/metadata.json
  • prompt_id when available
  • relevant vibecomfy logs tail lines if execution failed

Do not report an edit candidate as a run result. A candidate graph from the Comfy app or agentic edit harness becomes a run result only after it is applied or executed through vibecomfy run / runtime APIs.

© peteromallet, 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 docs/agent-skill/skills/run-comfy-workflow of peteromallet/VibeComfy.

Open the folder on GitHubat commit b1429c6

Compare with similar skills

Run Comfy Workflow 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.

Run Comfy Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Comfy Workflow this skillpeteromallet/VibeComfy150—~1.8kAutomated safety check: PassMIT
Writing Playwright TestsComfy-Org/ComfyUI_frontend2.1k—~2.3kAutomated safety check: PassGPL-3.0
Reviewing Unit TestsComfy-Org/ComfyUI_frontend2.1k—~5.1kAutomated safety check: PassGPL-3.0
Iibzanllp/infinite-image-browsing1.4k—~3.3kAutomated safety check: PassMIT
Comfyui Skill OpenclawHuangYuChuh/ComfyUI_Skills_OpenClaw411—~2.7kAutomated safety check: PassApache-2.0
Character Refseternityspring/shuohao-skills4.2k—~1.7kAutomated safety check: WarnApache-2.0

Similar skills

  • Writing Playwright Tests

    Comfy-Org/ComfyUI_frontend

    Writes Playwright e2e tests for ComfyUIfrontend. An agent skill from Comfy-Org/ComfyUI_frontend.

    2.1k GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Reviewing Unit Tests

    Comfy-Org/ComfyUI_frontend

    A skill your agent uses when reviewing Vitest unit-test diffs in ComfyUIfrontend, especially new mocks, store tests, component tests, or bugfix regression tests.

    2.1k GitHub stars~5.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Iib

    zanllp/infinite-image-browsing

    Interact with IIB (Infinite Image Browsing) service for searching, browsing, tagging, and organizing AI-generated images.

    1.4k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • 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.

    411 GitHub stars~2.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Character Refs

    eternityspring/shuohao-skills

    给任何故事里的角色真出参考图(小说改编、自己原创的故事、单独设计一个角色都行,不需要小说原文): 一段话描述角色,拆成分层字段、补全后确认, 先出一张正面全身锚点,其余视图(大头照、90° 侧面、背面、细节、45° 大头照)都只参考这张锚点, 按需分档出图。每张图带标识、可单独重出,重出后自动标出哪些图过期。

    4.2k GitHub stars~1.7k tokensUpdated 11 days ago
    Media & CreativeAuto-check: warnings
  • ComfyUI Custom Node Builder

    ConstantineB6/comfy-pilot

    Helps an agent write ComfyUI custom nodes in Python, including wrapping an existing script, mapping data types and handling image batches.

    230 GitHub stars~897 tokensUpdated 7 mo ago
    AI & LLM EngineeringAuto-check passed

More from peteromallet/VibeComfy

All 9 skills in this repo
  • Add Comfy Workflow Template

    peteromallet/VibeComfy

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

    150 GitHub stars~700 tokensUpdated 6 days ago
    Auto-check passed
  • Debug Comfy Workflow

    peteromallet/VibeComfy

    Diagnose a VibeComfy or ComfyUI workflow that fails validation, conversion, node/model resolution, runtime execution, or output production.

    150 GitHub stars~609 tokensUpdated 6 days ago
    Auto-check passed
  • Edit Comfy Workflow

    peteromallet/VibeComfy

    Edit an existing VibeComfy or ComfyUI workflow, ready template, recipe, scratchpad, or target graph.

    150 GitHub stars~2.2k tokensUpdated 6 days ago
    Auto-check passed
  • Explain Comfy Workflow

    peteromallet/VibeComfy

    Explain an existing VibeComfy or ComfyUI workflow, ready template, recipe, scratchpad, target graph, node chain, model path, prompt path, or runtime result.

    150 GitHub stars~806 tokensUpdated 6 days ago
    Auto-check passed
  • Reorganise Comfy Workflow

    peteromallet/VibeComfy

    Reorganise an existing ComfyUI workflow layout without changing runtime behavior.

    150 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Search Comfy Workflows

    peteromallet/VibeComfy

    Search for ComfyUI workflow precedents, VibeComfy ready templates, node wiring examples, Banodoco/Hivemind community workflow knowledge, and concrete graph patterns before editing or adding a…

    150 GitHub stars~966 tokensUpdated 6 days ago
    Auto-check passed

Works with

Questions about Run Comfy Workflow

What does Run Comfy Workflow do?

Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs. Run Comfy Workflow is an agent skill from peteromallet/VibeComfy. Execute an existing VibeComfy/ComfyUI workflow, ready template, recipe, or scratchpad and collect outputs.

When should I use Run Comfy Workflow?

Run Comfy Workflow fits situations like: the user asks to run; use a local/remote ComfyUI runtime.

How do I install Run Comfy Workflow in Claude Code?

Run `npx skills add peteromallet/VibeComfy --skill run-comfy-workflow -a claude-code`. Or copy the skill folder (docs/agent-skill/skills/run-comfy-workflow in peteromallet/VibeComfy) into .claude/skills/run-comfy-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Run Comfy Workflow in Codex?

Run `npx skills add peteromallet/VibeComfy --skill run-comfy-workflow -a codex`. Or copy the skill folder (docs/agent-skill/skills/run-comfy-workflow in peteromallet/VibeComfy) into .agents/skills/run-comfy-workflow in your project. Codex loads it when a task matches its description.

Can I use Run Comfy Workflow 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 peteromallet/VibeComfy --skill run-comfy-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-comfy-workflow, .gemini/skills/run-comfy-workflow, .github/skills/run-comfy-workflow and .opencode/skills/run-comfy-workflow in your project.

What does Run Comfy Workflow need to run?

Going by SKILL.md and its folder, Run Comfy Workflow needs the command-line tools its instructions call (python, uv and pytest). Our summary lists: Python 3.

Does Run Comfy Workflow access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Run Comfy Workflow 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 Run Comfy Workflow use?

Run Comfy Workflow 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 Run Comfy Workflow use?

About 1.8k tokens (SKILL.md is roughly 7k 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 Run Comfy Workflow?

Skills that share tags, products or a category with Run Comfy Workflow: Writing Playwright Tests (Comfy-Org/ComfyUI_frontend, 2.1k stars), Reviewing Unit Tests (Comfy-Org/ComfyUI_frontend, 2.1k stars), Iib (zanllp/infinite-image-browsing, 1.4k stars) and Comfyui Skill Openclaw (HuangYuChuh/ComfyUI_Skills_OpenClaw, 411 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Comfy Workflow?

peteromallet (a GitHub user) maintains it in peteromallet/VibeComfy, which has 150 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 1, 2026.

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