name: color-grade
description: Generate .cube 3D LUTs for color correction in DaVinci Resolve and Adobe Premiere Pro. Fixes exposure, color casts, skin tones, and black levels. Use when the user needs color grading, LUT generation, or frame analysis for video footage.
argument-hint: [lut-type] [output-path]
allowed-tools: Read, Bash(ruby *), Bash(python3 *), Bash(ffmpeg *), Write, Glob, Grep
Color Grade AI
Generate targeted .cube 3D LUTs for color correction. Works with DaVinci Resolve and Adobe Premiere Pro.
Quick Start
ruby generate_lut.rb <type> <output_path> [--strength=0.0-1.0]
ruby analyze_frame.rb <image_path> <x1,y1,x2,y2> [label]
ruby generate_docs.rb
Config-Driven Presets
All LUT types are defined in presets.yml. Each preset is a pipeline of ordered processing steps (exposure, black crush, skin correction, etc.). Adding a new LUT type means adding a YAML entry — no Ruby code changes needed.
Available LUT Types
| Type | What it fixes |
|---|
night_warm_fix | All-in-one for underexposed scenes with warm/red practicals. ~1 stop lift + skin hue shift + black crush. No desaturation — preserves vivid reds. Use with just AMIRA. |
night_purple_fix | All-in-one for underexposed scenes with purple/magenta stage lighting. RGB rebalancing + ~2 stop lift + purple desat + skin hue shift + black crush. Preserves atmospheric purple while fixing skin. |
yellow_fix | Warm amber/yellow cast from stage lighting. H=10-60, 55% desat. |
red_skin_fix | Sunburnt/flushed red skin from warm practicals. Hue shift to peach, skin-only targeting. |
overexposure_fix | Scene-wide ~1 stop reduction with highlight rolloff. |
underexposure_fix | Scene-wide ~1.2 stop lift with shadow recovery. |
black_crush | Crushes milky/lifted blacks below 12% to true black. |
