preflight-release

Run preflight checks on Python syntax, metadata consistency, and fixture validity.

7|2|Updated Sep 28, 2025
One-click install
npx skills add https://github.com/malkuthro/ComfyUI-Koolook --skill preflight-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight-release
Source: https://github.com/malkuthro/ComfyUI-Koolook/tree/main/.claude/skills/preflight-release
Command: npx skills add https://github.com/malkuthro/ComfyUI-Koolook --skill preflight-release

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers verify that project code and metadata are correct and consistent, preventing issues that could break workflows or cause deployment failures.

Core Features & Use Cases

  • Static Code Analysis: Checks all Python files for syntax errors and correct NODE_CLASS_MAPPINGS definitions, ensuring registration accuracy.
  • Dispatch Function Validation: Mocks tensor objects to test VAE dispatch logic, catching regressions in handling different input shapes.
  • Metadata Consistency: Compares upstream extension-node map data against local node IDs to identify discrepancies or drift.
  • Workflow Fixture Validation: Verifies that node IDs referenced in test fixtures are still registered, avoiding broken saved workflows.

Quick Start

Run the script tools/preflight_release.py to perform all checks and verify the project's codebase integrity before release.

Frequently Asked Questions about preflight-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate code and metadata consistency before a release?

To validate code and metadata consistency before a release, run the preflight release script to check Python syntax, NODE_CLASS_MAPPINGS definitions, and metadata drift against upstream extension-node map data.

What is static code analysis for node registration accuracy?

Static code analysis for node registration verifies that Python files have no syntax errors and correct NODE_CLASS_MAPPINGS definitions, ensuring accurate node registration and preventing deployment failures.

How do I check if node IDs in test fixtures are still registered?

Workflow fixture validation checks if node IDs referenced in test fixtures are still registered, which helps you avoid broken saved workflows and identify discrepancies caused by upstream metadata drift.

Do I need external dependencies to run preflight release checks?

No, you do not need external dependencies to run preflight release checks; the validation scripts require only a standard Python environment to verify code syntax, dispatch logic, and metadata consistency.

Why does VAE dispatch logic validation mock tensor objects?

VAE dispatch logic validation mocks tensor objects to test handling of different input shapes, catching regressions in dispatch logic before merging significant changes affecting node configurations.