| name | reference-look-calibration |
| description | Calibrate Blender materials, lighting, camera crop, emission/glow, color management, and aura/HUD styling against supplied original/reference images using measurable color, brightness, saturation, bbox, and mask statistics. Use when a product must match the lighting/look of a source image or when audits say the product is too bright, desaturated, wrong hue, wrong glow, or wrong silhouette extent. |
| when_to_use | Reference-based look-dev, lighting/material/color calibration, original-image visual matching, glow/aura/HUD matching, HSV/brightness/mask fit reports, final look pass after geometry and UV are locked. |
| allowed-tools | Read Bash Glob Grep mcp__blender__execute_blender_code mcp__blender__get_scene_info mcp__blender__get_object_info |
Reference Look Calibration
This skill handles the final visual match after geometry and UVs are locked. It must not compensate for wrong shape, wrong UVs, or wrong camera framing.
Inputs
- accepted geometry / UV fit reports;
- reference/original image(s);
- product preview render(s);
- optional mask overlays and multiview fit reports.
Metrics
Use scripts/look_fit_report.py to compare:
- object/bright-mask IoU and bbox extent;
- configured hue-band mask IoU for glow/accent assets;
- mean/std HSV and BGR under object mask;
- brightness p95 / mean;
- saturation mean;
- hue drift.
Calibration order
- Camera crop / orthographic scale — object extent must match before color tuning.
- World/background darkness.
- Base material hue/value/saturation.
- Emission strength and glow color.
- Aura/HUD ring color and thickness.
- Color management / exposure / gamma.
- Final render overlay and metrics.
Hard rules
- Do not tune lighting before geometry/UV fit gates pass.
- Do not change accent/glow hue away from the source reference unless the user explicitly asks.
- Do not hide mismatched geometry with bloom, fog, or overexposure.
- Write look metrics before and after calibration.
Handoff
Consumes validation/multiview_fit_report*.json and product previews. Produces validation/look_fit_report.json, look overlays, and updated material/light/render settings.