Communitygithub.com

비디오 비교기

두 비디오를 비교하여 압축 결과나 품질 차이를 분석할 때 사용합니다. PSNR, SSIM 같은 품질 측정항목과 프레임별 시각적 비교를 포함한 대화형 HTML 보고서를 생성합니다.

비디오 비교기란 무엇인가요?

이 스킬은 두 개의 비디오 파일(예: 원본과 압축본)을 비교하여 자세한 품질 분석 보고서를 생성합니다. PSNR(피크 신호 대 잡음비)과 SSIM(구조적 유사성 지수) 같은 표준 품질 측정항목을 계산하고, 슬라이더, 나란히 보기, 그리드의 세 가지 모드로 프레임별 시각적 비교를 제공하는 완전한 대화형 HTML 보고서를 만듭니다. FFmpeg를 사용해 비디오 메타데이터를 추출하고, FFprobe로 프레임을 캡처하며, 보고서는 모든 요소를 자체 포함하여 오프라인에서도 작동합니다. compare_videos, video quality, compression analysis 같은 문구가 포함된 사용자 요청에 반응하며, Claude Code, Cursor, Codex 등 AI 비서 환경에서 실행되도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/daymade/claude-code-skills/video-comparer

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

비디오 비교기은(는) 무엇을 하나요?

개요

두 비디오를 비교하고 압축 결과를 분석하는 대화형 HTML 보고서를 생성합니다. 스크립트는 비디오 메타데이터를 추출하고, 품질 측정항목(PSNR, SSIM)을 계산하며, 세 가지 보기 모드(슬라이더, 나란히 보기, 그리드)로 프레임별 시각적 비교를 만듭니다.

이 스킬을 사용해야 하는 경우

다음과 같은 경우에 이 스킬을 사용하세요:

  • 원본 비디오와 압축 비디오를 비교할 때
  • 비디오 압축 품질과 효율성을 분석할 때
  • 코덱 성능이나 비트레이트 감소 영향을 평가할 때
  • 사용자가 "비디오 비교", "비디오 품질", "압축 분석", "압축 전/후 비교" 등을 언급할 때

핵심 사용법

기본 명령어

python3 scripts/compare.py original.mp4 compressed.mp4

comparison.html 생성:

  • 비디오 매개변수(코덱, 해상도, 비트레이트, 길이, 파일 크기)
  • 품질 측정항목(PSNR, SSIM, 크기/비트레이트 감소율)
  • 프레임별 비교(기본값: 5초 간격 프레임)

명령어 옵션

# 사용자 정의 출력 파일
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# 사용자 정의 프레임 간격 (값이 클수록 프레임 수가 적어 처리 속도 향상)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# 배치 비교
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 및 FFprobe (비디오 분석 및 프레임 추출에 필요):

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# https://ffmpeg.org/download.html 에서 다운로드
# 또는 winget install ffmpeg 사용

Python 3.8+ (타입 힌트, f-strings, pathlib 사용)

비디오 사양

  • 지원 형식: .mp4 (권장), .mov, .avi, .mkv, .webm
  • 파일 크기 제한: 비디오당 500MB (설정 가능)
  • 처리 시간: 일반 비디오의 경우 약 1-2분; 길이와 프레임 간격에 따라 다름

스크립트 동작

자동 유효성 검사

스크립트는 자동으로 다음을 검증합니다:

  • FFmpeg/FFprobe 설치 및 가용성
  • 파일 존재 여부, 확장자 및 크기 제한
  • 경로 보안 (디렉터리 트래버설 방지)

유효성 검사 실패 시 해결 방법을 안내하는 명확한 오류 메시지가 표시됩니다.

품질 측정항목

스크립트는 두 가지 표준 품질 측정항목을 계산합니다:

PSNR (피크 신호 대 잡음비): 픽셀 수준 유사도 측정 (20-50 dB 범위, 높을수록 좋음)

SSIM (구조적 유사성 지수): 지각적 유사도 측정 (0.0-1.0 범위, 높을수록 좋음)

자세한 해석 척도와 품질 임계값은 references/video_metrics.md를 참조하세요.

프레임 추출

스크립트는 지정된 간격(기본값: 5초)으로 프레임을 추출하고, 일관된 높이(800px)로 크기를 조정하여 비교하며, base64 데이터 URL로 자체 포함 HTML에 내장합니다. 처리 후 임시 파일은 자동으로 정리됩니다.

출력 보고서

생성된 HTML 보고서에는 다음이 포함됩니다:

  • 슬라이더 모드: 드래그하여 원본과 압축본 비교 (기본값)
  • 나란히 보기 모드: 직접 비교를 위한 동시 표시
  • 그리드 모드: 간결한 2열 레이아웃
  • 확대/축소 컨트롤: 50%-200% 배율
  • 자체 포함 형식 (서버 불필요, 오프라인 작동)

중요한 구현 세부 사항

보안

스크립트는 다음을 구현합니다:

  • 경로 유효성 검사 (절대 경로, 디렉터리 트래버설 방지)
  • 명령어 주입 방지 (shell=True 사용 안 함, 검증된 인수)
  • 리소스 제한 (파일 크기, 시간 초과)
  • 사용자 정의 예외: ValidationError, FFmpegError, VideoComparisonError

일반적인 오류 시나리오

"FFmpeg not found": 플랫폼 패키지 관리자를 통해 FFmpeg 설치 (요구 사항 섹션 참조)

"File too large": 비교 전 비디오 압축, 또는 scripts/compare.py에서 MAX_FILE_SIZE_MB 조정

"Operation timed out": FFMPEG_TIMEOUT 상수 증가 또는 더 큰 --interval 값 사용 (처리하는 프레임 수 감소)

"Frame count mismatch": 비디오 길이/프레임 속도가 다름; 스크립트가 자동으로 최소 프레임 수로 자르고 경고 표시

설정

스크립트에는 파일 크기 제한, 시간 초과, 프레임 크기 및 추출 간격에 대한 조정 가능한 상수가 포함되어 있습니다. 동작을 사용자 정의하려면 scripts/compare.py 상단의 상수를 편집하세요. 자세한 설정 옵션과 영향은 references/configuration.md를 참조하세요.

참고 자료

자세한 정보는 다음 파일을 참조하세요:

  • references/video_metrics.md: 품질 측정항목 해석 (PSNR/SSIM 척도, 압축 목표, 비트레이트 가이드라인)
  • references/ffmpeg_commands.md: FFmpeg 명령어 참조 (메타데이터 추출, 프레임 추출, 문제 해결)
  • references/configuration.md: 스크립트 설정 옵션 및 조정 가능한 상수
  • assets/template.html: 보기 모드 및 스타일 사용자 정의를 위한 HTML 보고서 템플릿

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬