Communitygithub.com

Biznomad/agent-skills

두 동영상을 비교하여 압축 결과나 품질 차이를 분석할 때 사용합니다. PSNR, SSIM 같은 품질 지표와 프레임별 시각적 비교를 포함한 대화형 HTML 보고서를 생성합니다.

agent-skills란 무엇인가요?

이 스킬은 원본 동영상과 압축된 동영상을 비교하여 압축 품질을 분석하는 데 사용됩니다. 사용자가 '동영상 비교', '동영상 품질', '압축 분석', '전/후 압축' 등을 요청할 때 자동으로 실행됩니다. 이 스킬은 비디오 메타데이터를 추출하고 PSNR과 SSIM 같은 표준 품질 지표를 계산하며, 슬라이더, 나란히 보기, 그리드의 세 가지 보기 모드를 지원하는 프레임별 시각적 비교를 포함한 완전한 대화형 HTML 보고서를 생성합니다. Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, Python 스크립트와 FFmpeg 의존성을 기반으로 동작합니다. 자동 유효성 검사, 보안 강화 (경로 검증, 명령어 주입 방지), 리소스 제한 (파일 크기, 타임아웃) 기능을 포함하여 안전하고 안정적인 분석을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-comparer

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

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

문서

Video Comparer

개요

두 동영상을 비교하고 압축 결과를 분석하는 대화형 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 (Peak Signal-to-Noise Ratio): 픽셀 수준 유사도 측정 (20-50 dB 범위, 높을수록 좋음)

SSIM (Structural Similarity Index): 지각적 유사도 측정 (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.

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

관련 스킬