Communitygithub.com

Comparador de Videos

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. Se activa cuando los usuarios mencionan 'comparar videos', 'calidad de video', 'análisis de compresión', 'antes/después de compresión' o solicitan evaluación de calidad de videos comprimidos.

¿Qué es Comparador de Videos?

Este skill es una herramienta especializada para desarrolladores y analistas de video que necesitan comparar dos archivos de video (por ejemplo, original vs. comprimido) y generar un informe detallado de calidad. Proporciona un script en Python que extrae metadatos de video, calcula métricas objetivas de calidad como PSNR (Relación Señal-Ruido Pico) y SSIM (Índice de Similitud Estructural), y produce un informe HTML interactivo completamente autónomo. El informe incluye tres modos de visualización (deslizador, lado a lado y cuadrícula), controles de zoom y permite la inspección cuadro por cuadro. El skill automatiza la validación de requisitos del sistema (FFmpeg), la extracción de cuadros y la generación del reporte, soportando múltiples formatos de video comunes y ofreciendo opciones de personalización como intervalo de extracción de cuadros y nombre del archivo de salida. Está diseñado para funcionar en macOS, Linux y Windows, y se integra fácilmente en flujos de trabajo de análisis de compresión y evaluación de codecs.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-comparer

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Comparador de Videos?

Descripción general

Compara dos videos y genera un informe HTML interactivo analizando los resultados de compresión. El script extrae metadatos de video, 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:

  • Comparas videos originales y comprimidos
  • Analizas la calidad y eficiencia de la compresión de video
  • Evalúas el rendimiento de un codec 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 de 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 reporte.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 originales/*.mp4; do
    comprimido="comprimido/$(basename "$original")"
    salida="reportes/$(basename "$original" .mp4).html"
    python3 scripts/compare.py "$original" "$comprimido" -o "$salida"
done

Requisitos

Dependencias del sistema

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

# macOS
brew install ffmpeg

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

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

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

Especificaciones de video

  • Formatos admitidos: .mp4 (recomendado), .mov, .avi, .mkv, .webm
  • Límite de tamaño de archivo: 500MB 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 el directory traversal)

Cuando falla la validación, aparecen mensajes de error claros con orientación para resolverlos.

Métricas de calidad

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

PSNR (Relación Señal-Ruido Pico): Medición de similitud a nivel de píxeles (escala 20-50 dB, cuanto más alto mejor)

SSIM (Índice de Similitud Estructural): Medición de similitud perceptual (escala 0.0-1.0, cuanto más alto 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 consistente (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 (por defecto)
  • 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, timeouts)
  • Excepciones personalizadas: ValidationError, FFmpegError, VideoComparisonError

Escenarios de error comunes

"FFmpeg no encontrado": Instala FFmpeg a través del gestor de paquetes de tu plataforma (consulta la sección Requisitos)

"Archivo demasiado grande": Comprime los videos antes de la comparación, o ajusta MAX_FILE_SIZE_MB en scripts/compare.py

"Operación agotó el tiempo": Aumenta la constante FFMPEG_TIMEOUT o usa un valor de --interval mayor (procesa menos cuadros)

"El número de cuadros no coincide": 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, timeouts, dimensiones de cuadros e intervalos de extracción. Para personalizar el comportamiento, edita las constantes al inicio 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 de informe HTML para personalizar modos de visualización y estilo

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.

Skills relacionados