# Add Comfy Workflow Template

> Add a durable VibeComfy ready workflow/template from a ComfyUI source workflow. Use when the user asks to add a new ready template, promote a workflow into ready_templates, add a model family/capability, update coverage manifests, or make a workflow reusable by id.

- Skill: `peteromallet/add-comfy-workflow-template` (Agent Skill)
- Install (CLI): `npx skillmds@latest add peteromallet/add-comfy-workflow-template`
- Raw SKILL.md: https://api.skillmd.com/api/skills/peteromallet/add-comfy-workflow-template/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: peteromallet (https://skillmd.com/u/peteromallet)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/peteromallet/add-comfy-workflow-template

---


# Add Comfy Workflow Template

Use this only for durable package templates. For a one-off user composition, create a gitignored `recipes/` file instead.

Read `docs/templates/adding_templates_models.md` before broad template or model-family work.

## Fast Path

1. Choose a stable id: `<media>/<lower_snake_model_capability>`.
2. Store source JSON close to upstream:

```text
ready_templates/sources/official/<media>/<id>.json
ready_templates/sources/community/<source>/<id>.json
ready_templates/sources/custom_nodes/<pack>/<source>/<id>.json
```

3. Add or update `ready_templates/sources/manifests/coverage.json`.
4. Declare custom-node packs in `vibecomfy/node_packs.py` or the relevant pack module; update `custom_nodes.lock` when needed.
5. Declare models in `vibecomfy/registry/models.yaml` when workflow metadata is not enough.
6. Preflight and convert:

```bash
vibecomfy port check ready_templates/sources/.../<id>.json --json
vibecomfy nodes reconcile --workflow ready_templates/sources/.../<id>.json --json
vibecomfy port convert ready_templates/sources/.../<id>.json \
  --ready-id <media>/<id> \
  --out ready_templates/<media>/<id>.py \
  --json
```

7. Validate:

```bash
vibecomfy validate ready_templates/<media>/<id>.py
vibecomfy doctor ready_templates/<media>/<id>.py --json
pytest -q tests/test_ready_templates.py tests/test_runpod_matrix.py tests/test_nodes_install.py tests/test_cli_misc.py tests/test_cli_sources_workflows_nodes.py
```

8. Run focused GPU validation only when environment and cost are acceptable:

```bash
VIBECOMFY_MATRIX_SCOPE=<family> uv run python scripts/runpod_corpus_matrix.py
```

## Rules

- Keep template additions narrow: source, manifest, node/model declarations, template, focused tests.
- Do not hand-edit generated templates unless you preserve converter markers and parity expectations.
- Do not hide known failures in chat or pod logs. Document incompatibilities in `docs/runtime/incompatibilities.md`, `docs/structural_issues.md`, or a family coverage doc.
- If the request is just "make this custom workflow for me", use `edit-comfy-workflow` and `recipes/`, not `ready_templates/`.