grade-consistency-pass

Match video clip color statistics to a reference clip using ffmpeg filters.

6|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/gooseworks-ai/gooseworks-ads-skills --skill grade-consistency-pass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grade-consistency-pass
Source: https://github.com/gooseworks-ai/gooseworks-ads-skills/tree/main/skills/atoms/color/grade-consistency-pass
Command: npx skills add https://github.com/gooseworks-ai/gooseworks-ads-skills --skill grade-consistency-pass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill applies uniform color grading across all clips in an ad run, ensuring consistent contrast, saturation, and gamma, without manual color correction.

Core Features & Use Cases

  • Automated Color Correction: Matches mean color statistics of every clip to a reference clip, applying an ffmpeg filter to reduce inter-clip variance.
  • Reference Clip Matching: Selects a reference clip to establish a base color profile for all other clips.
  • Custom Adjustment: Allows customization of channels to match (y, u, v) and maximum adjustment delta.
  • Use Case: Improve the visual consistency of a series of advertisement clips by matching the color grading across different scenes.

Quick Start

Use the grade-consistency-pass skill to grade the color of the 'scene-clips' directory, using 'scene-01.mp4' as the reference clip.

Frequently Asked Questions about grade-consistency-pass

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

FAQPage Schema
How do I match color grading across multiple video clips using ffmpeg?

Color grading across multiple video clips is matched by analyzing mean color statistics of a reference clip and applying ffmpeg filters to adjust other clips, ensuring uniform contrast, saturation, and gamma without manual correction.

What is the best way to ensure visual consistency across ad clips in post-production?

Visual consistency in ad clip post-production is achieved by selecting a reference clip to establish a base color profile, then automatically matching the mean color statistics of all other clips to that reference using ffmpeg.

Can I customize which color channels ffmpeg matches when correcting video?

You can customize color correction by specifying which YUV channels to match, such as y, u, and v, and by setting a maximum adjustment delta to control the strength of the color grading applied across clips.

Do I need any special software to perform automated color correction on a directory of clips?

Automated color correction requires ffmpeg installed in your environment to apply the matching filters. You provide a directory of clips and a reference video file to establish the target color profile.

Why does my ad footage look inconsistent after color grading?

Inconsistent ad footage often results from inter-clip color variance. Matching mean color statistics to a single reference clip reduces this variance, applying uniform contrast, saturation, and gamma across all scenes.

Related Skills