footage-gate

Review source media, cut silence, auto color grade, and run cut-boundary QC via local FFmpeg pipelines.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill footage-gate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: footage-gate
Source: https://github.com/openakita/openakita/tree/main/plugins/footage-gate
Command: npx skills add https://github.com/openakita/openakita --skill footage-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, Pillow.

What problem does it solve?

Raw footage and exported masters often ship with hidden defects — low resolution, dead air, flat color, HDR clipping, or bad cut boundaries — and manually checking each one is slow and error-prone. Footage Gate automates post-production quality control with four deterministic, fully local FFmpeg pipelines, so you can verify and fix media before delivery without any cloud dependency.

Core Features & Use Cases

  • Source Review: Probe video, audio, and image files to flag low resolution, mono audio, or too-short clips, with an optional DashScope Paraformer transcription summary.
  • Silence Cut: Detect and remove dead air using pure-NumPy RMS analysis (no aubio dependency), then concat the kept segments with FFmpeg.
  • Auto Color Grade: Sample frames with signalstats to derive a clamped eq filter chain, automatically prepending an HDR-to-SDR tonemap chain for HLG/PQ sources.
  • Cut Boundary QC: Run four checks (boundary frame jitter, waveform spikes, subtitle safe zones, EDL duration consistency) against an EDL JSON, with an optional auto-remux repair loop of up to 3 attempts.
  • Use Case: After exporting a master cut, run cut_qc with your EDL to catch a subtitle hidden behind the TikTok bottom UI and an audio spike at a cut point, then let the auto-remux loop fix both before delivery.

Quick Start

Ask the agent to create a footage-gate task, for example: run a source review on my uploaded video file and show me the quality risk report.

Frequently Asked Questions about footage-gate

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

FAQPage Schema
How do I remove silence from a video automatically?▼

Use the silence_cut mode, which detects non-silent intervals with pure-NumPy RMS analysis and concatenates the kept segments via FFmpeg. You can tune threshold_db, min_silence_len, min_sound_len, and pad parameters per task.

How to check video cut quality against an EDL file?▼

Use the cut_qc mode with an EDL JSON payload describing your cuts. It runs four checks — boundary frame jitter, waveform spikes, subtitle safe zones, and duration consistency — and optionally auto-remuxes up to 3 times to fix issues.

Does this video QC tool work without an internet connection?▼

Yes, all four modes run entirely on local FFmpeg with no LLM or API dependency in the default path. The only optional cloud call is DashScope Paraformer transcription in source_review, which is off by default and requires your own API key.

Can FFmpeg auto color grade HDR footage?▼

Yes, the auto_color mode detects HDR transfers (smpte2084, arib-std-b67) via ffprobe and prepends a zscale plus tonemap=hable chain before the eq grade filter. This converts HLG/PQ sources to BT.709 SDR and prevents the clipping that occurs when grading HDR directly.

What are the limitations of automated cut boundary QC?▼

The boundary frame check uses histogram-style pixel diffs, so hard-edged whip-pans can register as false positives. Auto color only applies a single global eq chain, and scene-aware grading is deferred to a later version.

Why does silence detection fail with aubio on newer Python?▼

The aubio package fails to install on Python 3.10+ with NumPy 1.24+, which is a known upstream issue. This skill avoids the problem entirely by implementing silence detection in pure NumPy with no aubio, madmom, or librosa dependency.