Communitygithub.com

ComeOnOliver/skillshub

Esta habilidad se utiliza para comparar dos videos y analizar resultados de compresión o diferencias de calidad. Genera informes HTML interactivos con métricas de calidad (PSNR, SSIM) y comparaciones visuales cuadro por cuadro.

¿Qué es skillshub?

Esta habilidad para agentes de IA, como Claude Code, Cursor o Codex, permite comparar dos videos y generar un informe HTML interactivo que analiza los resultados de compresión. Es útil para evaluar la calidad de video, comparar codecs, o ver el impacto de la reducción de bitrate. El script extrae metadatos de los videos, calcula métricas de calidad estándar como PSNR y SSIM, y crea una comparación visual cuadro por cuadro con tres modos de visualización (deslizador, lado a lado y cuadrícula). Funciona con Python 3.8+ y requiere FFmpeg/FFprobe. Los informes son autónomos, no requieren servidor y funcionan sin conexión. La habilidad se activa cuando el usuario menciona frases como "comparar videos", "calidad de video" o "análisis de compresión".

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Comparador de Videos

Resumen

Compara dos videos y genera un informe HTML interactivo que analiza los resultados de compresión. El script extrae metadatos de los videos, calcula métricas de calidad (PSNR, SSIM) y crea comparaciones visuales cuadro por cuadro con tres modos de visualización: deslizador, lado a lado y cuadrícula.

Cuándo usar esta habilidad

Usa esta habilidad cuando:

  • Se comparan videos originales y comprimidos
  • Se analiza la calidad y eficiencia de la compresión de video
  • Se evalúa el rendimiento de un códec o el impacto de la reducción de bitrate
  • Los usuarios mencionan "comparar videos", "calidad de video", "análisis de compresión" o "antes/después de compresión"

Uso principal

Comando básico

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

Genera comparison.html con:

  • Parámetros del video (códec, resolución, bitrate, duración, tamaño de archivo)
  • Métricas de calidad (PSNR, SSIM, porcentajes de reducción de tamaño/bitrate)
  • Comparación cuadro por cuadro (por defecto: cuadros cada 5 segundos)

Opciones de comando

# Archivo de salida personalizado
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# Intervalo de cuadros personalizado (mayor = menos cuadros, procesamiento más rápido)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# Comparación por lotes
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

Requisitos

Dependencias del sistema

FFmpeg y FFprobe (necesarios para análisis de video y extracción de cuadros):

# macOS
brew install ffmpeg

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

# Windows
# Descargar de https://ffmpeg.org/download.html
# O usar: winget install ffmpeg

Python 3.8+ (usa type hints, f-strings, pathlib)

Especificaciones de video

  • Formatos compatibles: .mp4 (recomendado), .mov, .avi, .mkv, .webm
  • Límite de tamaño de archivo: 500 MB por video (configurable)
  • Tiempo de procesamiento: ~1-2 minutos para videos típicos; varía según la duración y el intervalo de cuadros

Comportamiento del script

Validación automática

El script valida automáticamente:

  • Instalación y disponibilidad de FFmpeg/FFprobe
  • Existencia de archivos, extensiones y límites de tamaño
  • Seguridad de rutas (previene directory traversal)

Aparecen mensajes de error claros con orientación para la resolución cuando la validación falla.

Métricas de calidad

El script calcula dos métricas de calidad estándar:

PSNR (Peak Signal-to-Noise Ratio): Medición de similitud a nivel de píxel (escala de 20-50 dB, más alto es mejor)

SSIM (Structural Similarity Index): Medición de similitud perceptual (escala de 0.0-1.0, más alto es mejor)

Para escalas de interpretación detalladas y umbrales de calidad, consulta references/video_metrics.md.

Extracción de cuadros

El script extrae cuadros en intervalos especificados (por defecto: 5 segundos), los escala a una altura uniforme (800px) para la comparación, y los incrusta como URLs de datos base64 en un HTML autónomo. Los archivos temporales se eliminan automáticamente después del procesamiento.

Informe de salida

El informe HTML generado incluye:

  • Modo deslizador: Arrastra para revelar original vs comprimido (predeterminado)
  • Modo lado a lado: Visualización simultánea para comparación directa
  • Modo cuadrícula: Diseño compacto de 2 columnas
  • Controles de zoom: Magnificación del 50% al 200%
  • Formato autónomo (no requiere servidor, funciona sin conexión)

Detalles importantes de implementación

Seguridad

El script implementa:

  • Validación de rutas (rutas absolutas, previene directory traversal)
  • Prevención de inyección de comandos (sin shell=True, argumentos validados)
  • Límites de recursos (tamaño de archivo, tiempos de espera)
  • Excepciones personalizadas: ValidationError, FFmpegError, VideoComparisonError

Escenarios de error comunes

"FFmpeg not found": Instala FFmpeg mediante el gestor de paquetes de la plataforma (ver sección Requisitos)

"File too large": Comprime los videos antes de la comparación, o ajusta MAX_FILE_SIZE_MB en scripts/compare.py

"Operation timed out": Aumenta la constante FFMPEG_TIMEOUT o usa un valor mayor de --interval (procesa menos cuadros)

"Frame count mismatch": Los videos tienen diferentes duraciones/tasas de cuadros; el script trunca automáticamente al número mínimo de cuadros y muestra una advertencia

Configuración

El script incluye constantes ajustables para límites de tamaño de archivo, tiempos de espera, dimensiones de cuadros e intervalos de extracción. Para personalizar el comportamiento, edita las constantes al principio de scripts/compare.py. Para opciones de configuración detalladas y sus impactos, consulta references/configuration.md.

Materiales de referencia

Consulta estos archivos para obtener información detallada:

  • references/video_metrics.md: Interpretación de métricas de calidad (escalas PSNR/SSIM, objetivos de compresión, guías de bitrate)
  • references/ffmpeg_commands.md: Referencia de comandos FFmpeg (extracción de metadatos, extracción de cuadros, solución de problemas)
  • references/configuration.md: Opciones de configuración del script y constantes ajustables
  • assets/template.html: Plantilla del informe HTML para personalizar modos de visualización y estilos

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

Skills relacionados