video-debugging

Diagnose video playback and quality issues via metadata inspection and frame extraction.

10|Updated Dec 15, 2014
One-click install
npx skills add https://github.com/baleen37/dotfiles --skill video-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-debugging
Source: https://github.com/baleen37/dotfiles/tree/main/users/shared/.config/claude/skills/video-debugging
Command: npx skills add https://github.com/baleen37/dotfiles --skill video-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, ffprobe.

What problem does it solve?

This Skill solves complex video playback and quality issues by providing a structured diagnostic workflow that works without needing the original reference video.

Core Features & Use Cases

  • 5-Step Diagnostic Workflow: Triage → Categorize → Analyze → Diagnose → Recommend for all video problems
  • No Reference Required: Uses metadata analysis and frame extraction instead of comparison metrics
  • Use Case: When a video won't play properly, has blocky artifacts, or shows color issues, this Skill systematically identifies the root cause and provides specific solutions.

Quick Start

Use the video-debugging skill to diagnose why my video file 'presentation.mp4' has blurry quality and won't stream properly in browsers.

Frequently Asked Questions about video-debugging

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

FAQPage Schema
How do I diagnose why my video won't play or has quality issues?

Video diagnostics use metadata inspection and frame extraction to identify root causes without needing a reference file. This Skill applies a 5-step workflow—triage, categorize, analyze, diagnose, recommend—to pinpoint playback failures, blocky artifacts, color inaccuracies, A/V sync problems, and codec compatibility issues across formats.

Can I fix video quality problems like blurry frames or color corruption without the original file?

Yes. This Skill performs non-reference video analysis by extracting and inspecting frame data and codec metadata to identify corruption, compression artifacts, and quality degradation. It then recommends specific remediation steps tailored to the detected issue.

What video formats and codecs does this approach work with?

The Skill uses ffmpeg and ffprobe to inspect and analyze video across formats and codecs. It handles playback failures, synchronization problems, and container compatibility concerns by examining file metadata and extracting diagnostic frame information regardless of codec.

How do I check if A/V sync issues or codec problems are causing my streaming failures?

Run per-file checks using metadata analysis to detect synchronization drift and codec–container mismatches. The diagnostic workflow categorizes the issue type, analyzes frame and timing data, and recommends format conversion or repackaging as needed.

What's the difference between this approach and comparing against a reference video?

This Skill performs standalone triage without reference comparisons, relying instead on intrinsic metadata and frame-level analysis. It identifies corruption and quality degradation patterns directly from the file, making it faster when reference files are unavailable or when multiple files need rapid triage.

Do I need ffmpeg installed to use this video troubleshooting workflow?

Yes. ffmpeg and ffprobe are required dependencies. They extract codec data, frame metadata, and allow frame extraction for quality analysis. Ensure both tools are available in your environment before running diagnostics.