color-correction

# Color Correction (measure, don't eyeball) ## The core principle **You cannot reliably judge color from a storyboard / contact sheet.** "Is it washed out?" flip-flops by eye, especially on AI-gen video. Make color **measurable** with the `analyze_color` MCP tool, read the numbers like a colorist reads scopes, then pick the fix the data points to — and re-measure to confirm. The whole skill is this loop: ``` extract a frame ─► analyze_color ─► read black/white points + contrast + saturation ▲ │ │ ▼ re-measure ◄──── apply fix (levels / contrast / match) ◄── diagnose from the numbers ``` > Origin: on a WAN-Animate render we argued for many turns over whether the clip was > "washed out." The instant we measured it, the answer was unambiguous and the *correct* > fix (a contrast stretch, NOT the color-match nodes we'd been adding) fell straight out. --- ## The `analyze_color` tool Read-only. Source = `asset_id`, a ComfyUI output ref (`filename`/`subfolder`/`type`), or an image `path` (absolute, or under the output dir). It returns per-image stats + heuristic flags + a one-line verdict, and (optional) an overlaid R/G/B/luma **histogram PNG**. ``` analyze_color({ filename: "render_00007_.png" }) # absolute numbers analyze_color({ path: "frame.png", reference_path: "src.jpg" }) # + shot-match deltas analyze_color({ filename: "x.png", histogram: true }) ...