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.
Works with
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versionvideo-comparerExecute the skills CLI command in your project's root directory to begin installation:
Fetches video-comparer from daymade/claude-code-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate video-comparer. Access via /video-comparer in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
0
total installs
0
this week
784
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
784
stars
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.
Use this skill when:
python3 scripts/compare.py original.mp4 compressed.mp4
Generates comparison.html with:
# 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
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)
.mp4 (recommended), .mov, .avi, .mkv, .webmThe script automatically validates:
Clear error messages with resolution guidance appear when validation fails.
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.
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.
The generated HTML report includes:
The script implements:
shell=True, validated arguments)ValidationError, FFmpegError, VideoComparisonError"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
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.
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 stylingPrerequisites
Time Estimate
15-45 minutes depending on use case complexity
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid when
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
daymade/claude-code-skills
daymade/claude-code-skills
daymade/claude-code-skills
affaan-m/everything-claude-code
remotion-dev/skills
supercent-io/skills-template
Registry listing for video-comparer matched our evaluation — installs cleanly and behaves as described in the markdown.
video-comparer reduced setup friction for our internal harness; good balance of opinion and flexibility.
video-comparer fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
Useful defaults in video-comparer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
Useful defaults in video-comparer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
Solid pick for teams standardizing on skills: video-comparer is focused, and the summary matches what you get after install.
video-comparer is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
video-comparer fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
We added video-comparer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
Registry listing for video-comparer matched our evaluation — installs cleanly and behaves as described in the markdown.
showing 1-10 of 66