video-comparer
This skill should be used when comparing two videos to analyze compression results or quality differences. Generates interactive HTML reports with quality metrics (PSNR, SSIM) and frame-by-frame visual comparisons.
Install / Use
npx skills add daymade/claude-code-skills --skill video-comparerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of video-comparer
video-comparer scores 87/100 on our quality scale, 2179th of 4,700 Development & Engineering skills we index (top 47%).
Its SKILL.md is 5.3 KB long, well organised into 27 sections with 3 code examples: a solid amount of guidance for an agent.
With 1,426 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so video-comparer is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
video-comparer compared with similar skills
All 4 of these similar skills score higher than video-comparer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| video-comparer (this skill)by daymade | 87 | 1.4k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install video-comparer?
- Run
npx skills add daymade/claude-code-skills --skill video-comparer. The install tabs above show the steps for each supported agent. - Which AI agents does video-comparer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is video-comparer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is video-comparer still maintained?
- The repository was last updated about 2 months ago, so video-comparer is actively maintained.
Skill content
View source on GitHubname: video-comparer description: This skill should be used when comparing two videos to analyze compression results or quality differences. Generates interactive HTML reports with quality metrics (PSNR, SSIM) and frame-by-frame visual comparisons. Triggers when users mention "compare videos", "video quality", "compression analysis", "before/after compression", or request quality assessment of compressed videos.
Video Comparer
Overview
Compare two videos and generate an interactive HTML report analyzing compression results. The script extracts video metadata, calculates quality metrics (PSNR, SSIM), and creates frame-by-frame visual comparisons with three viewing modes: slider, side-by-side, and grid.
When to Use This Skill
Use this skill when:
- Comparing original and compressed videos
- Analyzing video compression quality and efficiency
- Evaluating codec performance or bitrate reduction impact
- Users mention "compare videos", "video quality", "compression analysis", or "before/after compression"
Core Usage
Basic Command
python3 scripts/compare.py original.mp4 compressed.mp4
Generates comparison.html with:
- Video parameters (codec, resolution, bitrate, duration, file size)
- Quality metrics (PSNR, SSIM, size/bitrate reduction percentages)
- Frame-by-frame comparison (default: frames at 5s intervals)
Command Options
# Custom output file
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Custom frame interval (larger = fewer frames, faster processing)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10
# Batch comparison
for original in originals/*.mp4; do
compressed="compressed/$(basename "$original")"
output="reports/$(basename "$original" .mp4).html"
python3 scripts/compare.py "$original" "$compressed" -o "$output"
done
Requirements
System Dependencies
FFmpeg and FFprobe (required for video analysis and frame extraction):
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg
# Windows
# Download from https://ffmpeg.org/download.html
# Or use: winget install ffmpeg
Python 3.8+ (uses type hints, f-strings, pathlib)
Video Specifications
- Supported formats:
.mp4(recommended),.mov,.avi,.mkv,.webm - File size limit: 500MB per video (configurable)
- Processing time: ~1-2 minutes for typical videos; varies by duration and frame interval
Script Behavior
Automatic Validation
The script automatically validates:
- FFmpeg/FFprobe installation and availability
- File existence, extensions, and size limits
- Path security (prevents directory traversal)
Clear error messages with resolution guidance appear when validation fails.
Quality Metrics
The script calculates two standard quality metrics:
PSNR (Peak Signal-to-Noise Ratio): Pixel-level similarity measurement (20-50 dB scale, higher is better)
SSIM (Structural Similarity Index): Perceptual similarity measurement (0.0-1.0 scale, higher is better)
For detailed interpretation scales and quality thresholds, consult references/video_metrics.md.
Frame Extraction
The script extracts frames at specified intervals (default: 5 seconds), scales them to consistent height (800px) for comparison, and embeds them as base64 data URLs in self-contained HTML. Temporary files are automatically cleaned after processing.
Output Report
The generated HTML report includes:
- Slider Mode: Drag to reveal original vs compressed (default)
- Side-by-Side Mode: Simultaneous display for direct comparison
- Grid Mode: Compact 2-column layout
- Zoom Controls: 50%-200% magnification
- Self-contained format (no server required, works offline)
Important Implementation Details
Security
The script implements:
- Path validation (absolute paths, prevents directory traversal)
- Command injection prevention (no
shell=True, validated arguments) - Resource limits (file size, timeouts)
- Custom exceptions:
ValidationError,FFmpegError,VideoComparisonError
Common Error Scenarios
"FFmpeg not found": Install FFmpeg via platform package manager (see Requirements section)
"File too large": Compress videos before comparison, or adjust MAX_FILE_SIZE_MB in scripts/compare.py
"Operation timed out": Increase FFMPEG_TIMEOUT constant or use larger --interval value (processes fewer frames)
"Frame count mismatch": Videos have different durations/frame rates; script auto-truncates to minimum frame count and shows warning
Configuration
The script includes adjustable constants for file size limits, timeouts, frame dimensions, and extraction intervals. To customize behavior, edit the constants at the top of scripts/compare.py. For detailed configuration options and their impacts, consult references/configuration.md.
Reference Materials
Consult these files for detailed information:
references/video_metrics.md: Quality metrics interpretation (PSNR/SSIM scales, compression targets, bitrate guidelines)references/ffmpeg_commands.md: FFmpeg command reference (metadata extraction, frame extraction, troubleshooting)references/configuration.md: Script configuration options and adjustable constantsassets/template.html: HTML report template for customizing viewing modes and styling
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
