ComfyUI-Koolook

Set up an external upstream repository as a pinned reference checkout under ../ComfyUI-Forks and register it in MAIN's fork tracking files. Use when adding a new third-party fork, cloning the Radiance (or other) baseline on a fresh machine, registering an external repo for upstream sync work, bumping a fork to a new pinned version (creating a new vX_Y_Z folder), or when the user asks about the forks/ workflow.

Run the project's release-blocking sanity checks before merging or shipping. Verifies (1) all *.py files parse and the registered node-ID list can be statically extracted, (2) the VAE wrapper's rank/VAE-type dispatch branches still work via a stub-VAE roundtrip, (3) ComfyUI-Manager's upstream extension-node-map.json matches our actual node IDs (catches phantom-nodes drift like issue

Test-driven development with red-green-refactor loop, customised for ComfyUI-Koolook (Python nodes + ComfyUI sidebar JS + docs/designs/ visual specs). Use when the maintainer wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

Set up an external upstream repository as a pinned reference checkout under ../ComfyUI-Forks and register it in MAIN's fork tracking files. Use when adding a new third-party fork, cloning the Radiance (or other) baseline on a fresh machine, registering an external repo for upstream sync work, or asks about the forks/ workflow.

Render the LTX Director experiment-tracking card PNG from the latest workflow JSON in the working folder. One-shot. Reads the working folder path from the `KOLOOK_AUTOMATIONS_WORK_DIR` environment variable (loaded from `.env` at the repo root). Use when the maintainer types `/make-card`, `card`, or `make card` after exporting a workflow JSON from ComfyUI alongside a rendered video. Skill picks the newest `*.json` in the folder, runs `scripts/make_card.py`, writes `card.png` next to the JSON, and shows the PNG inline.

List all project-level skills for ComfyUI-Koolook under .claude/skills/ with their one-line descriptions, so the maintainer can browse what tools are available without remembering each one. Use when the user types /menu-comfy, "list project skills", "what project skills do we have", or "show me the project skill index". This is the project-specific inventory; user-level skills under ~/.claude/skills/ are listed separately by the global /menu skill.

Find-and-replace a version tag (or any string token) across docs, code constants, and manifests in one controlled pass. Use when bumping a fork from one version to another (e.g. v2_3_3 -> v2_4_0), renaming a node ID across the repo, or generally propagating a string change everywhere it's referenced. Takes <old-tag> and <new-tag>; optional --scope flag (all / docs / code) and --dry-run. Always shows every match before applying and re-verifies post-edit.

Run a license-compatibility audit before incorporating any third-party code into ComfyUI-Koolook (or any project that mixes licenses). Use when the user wants to fork a node, vendor a library, port a class from another repo, or add an external dependency. Must run BEFORE any code is copied or written based on upstream. Catches GPL/AGPL contamination of permissively-licensed projects (and vice-versa) early.