comfyui-export

Files (1)

• SKILL.md

SKILL.md (first lines)

# Pipeline → ComfyUI export

## Inputs

- A pipeline directory `pipelines/<name>/` with a complete `SPEC.md` and stage files.
- Target ComfyUI version assumption (default: current — flag if user hasn't updated recently).
- Optional: a checkpoint catalogue (`pipelines/_shared/checkpoints.md` or similar) so you can pick from models the user already has locally.

## Mapping

| Pipeline stage | ComfyUI nodes |
|----------------|---------------|
| Text-to-image (Flux) | `UNETLoader (flux)`, `DualCLIPLoader`, `CLIPTextEncode` ×2, `KSampler`, `VAEDecode`, `SaveImage` |
| Text-to-image (SDXL) | `CheckpointLoaderSimple`, `CLIPTextEncode` ×2, `KSampler`, `VAEDecode`, `SaveImage` |
| Image-to-video (SVD) | `ImageOnlyCheckpointLoader`, `SVD_img2vid_Conditioning`, `KSampler`, `VAEDecode`, `VHS_VideoCombine` |
| Image-to-video (Wan / Hunyuan) | corresponding loader + sampler + VHS combine |
| Upscale (Real-ESRGAN, 4x-UltraSharp) | `UpscaleModelLoader`, `ImageUpscaleWithModel` |
| Frame interpolation (RIFE / FILM) | `RIFE VFI` from `ComfyUI-Frame-Interpolation` |
| ControlNet | `ControlNetLoader`, `ControlNetApply` |
| LoRA | `LoraLoader` chained before sampler |

For stages that have **no native equivalent** (most lip-sync APIs, Runway Gen-3, Kling, Hailuo, Sora, Veo, ElevenLabs) — emit a placeholder Note node with the original API call documented, and tell the user this stage will still need to run via API even after the local move.

## Steps

1. Read `SPEC.md` and each `stages/NN-*.md`.
2. For each stage, look up the mapping. Use the local checkpoint catalogue if provided to pin specific filenames; otherwise emit `<choose checkpoint>` placeholders the user must fill.
3. Build the workflow as **API-format** JSON (flat `{node_id: {class_type, inputs}}`). Sequential numeric IDs starting from `1`. Wire `inputs` references as `[source_id, output_index]` pairs.
4. Set sampler params from the stage definitions (steps, cfg, sampler_name, scheduler, seed). API format has no "random" seed: `seed` must be an integer from 0 to 2^64−1, and `-1` fails validation. If the stage gives no seed, generate one (e.g. `python3 -c 'import secrets; print(secrets.randbelow(2**32))'`), write it into the workflow and record it in `manifest-export.md` so the run can be reproduced. Randomise-per-run is the UI's `control_after_generate` widget, which API format doesn't carry.
5. Write outputs:
   - `pipelines/<name>/comfy/workflow-export.json` — the API-format workflow.
   - `pipelines/<name>/comfy/manifest-export.md` — checkpoints, LoRAs, custom nodes the user needs (with `ComfyUI-Manager` install names where possible).
   - Update `SPEC.md` with a "Local execution" section pointing at the export.

## Discipline

- Be honest about gaps. If three of five stages map cleanly and two are API-only, say so on the first line of `manifest-export.md`. Don't pretend a full local equivalent exists.
- Don't invent ComfyUI nodes that don't exist. Verify class names against ComfyUI core + the relevant custom-node packs.
- Where a hosted model's quality is hard to match locally (Sora, Veo, Kling), explicitly say "no comparable local model — closest approximation is X but quality drop is significant".
- Keep the workflow JSON minimal — only the nodes that are part of the pipeline. No stray reroute nodes or notes (other than the gap-flag note for API-only stages).

From shotcowboystyle/ag-skills, MIT.

More from shotcowboystyle/ag-skills