video-quality-audit

name	video-quality-audit
description	Audit generated video quality with objective checks and produce an optimization plan for next render iteration.

Video Quality Audit

Use this skill after rendering and before final publishing.

Goal

Evaluate output video quality with reproducible checks, then provide focused optimization actions.

Checks

1. Metadata quality:

• inspect codec, fps, bitrate, width, height, duration using ffprobe.

2. Content readability:

• verify text size/readability, contrast, and pacing by sampling key timestamps.

3. Audio/visual consistency:

• ensure no frozen frames, severe stutter, or abrupt transitions.

4. Requirement match:

• compare output against issue constraints (target duration, style, language).

Suggested Commands

• ffprobe -v error -show_entries stream=codec_name,width,height,r_frame_rate,bit_rate -show_entries format=duration -of json <video.mp4>

Quality Gate

• Pass: technical metrics valid and visual readability acceptable.
• Warn: playable but one or more quality issues present.
• Fail: broken output, severe quality regression, or requirement mismatch.

Output Template

Video Quality Report

• gate: [pass|warn|fail]
• video: [path]
• metrics:
  • resolution: [e.g., 1920x1080]
  • fps: [e.g., 30]
  • duration_s: [e.g., 72.3]
  • bitrate: [value]
• findings:
  • [issue 1]
  • [issue 2]
• next_optimizations:
  • [specific action 1]
  • [specific action 2]

References

• ffprobe Documentation: https://ffmpeg.org/ffprobe.html
• Manim output and config: https://docs.manim.community/en/stable/tutorials/output_and_config.html
• GitHub Actions artifacts: https://docs.github.com/actions/using-workflows/storing-workflow-data-as-artifacts