Communitygithub.com

daymade/claude-code-skills

Esta skill debe utilizarse al comparar dos videos para 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 claude-code-skills?

Esta skill permite comparar dos videos (original y comprimido) y generar un informe HTML interactivo que analiza los resultados de la compresión. Está diseñada para desarrolladores y usuarios que necesitan evaluar la calidad de la codificación de video, el rendimiento de códecs o el impacto de la reducción de bitrate. Soporta múltiples plataformas (macOS, Linux, Windows) y utiliza herramientas como FFmpeg y FFprobe para extraer metadatos y cuadros. El informe incluye métricas estándar como PSNR y SSIM, junto con modos de visualización como deslizador, lado a lado y cuadrícula, lo que facilita una inspección detallada. La skill se activa cuando el usuario menciona términos como 'compare videos', 'video quality', 'compression analysis' o 'before/after compression'.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/daymade/claude-code-skills/tree/HEAD/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 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 Skill

Usa esta skill cuando:

  • Estés comparando videos originales y comprimidos
  • Analices la calidad y eficiencia de la compresión de video
  • Evalúes el rendimiento de códecs o el impacto de la reducción de bitrate
  • Los usuarios mencionen "compare videos", "video quality", "compression analysis" o "before/after compression"

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 en intervalos de 5s)

Opciones del Comando

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

# Intervalo de cuadros personalizado (más grande = 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 (requeridos 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 desde https://ffmpeg.org/download.html
# O usar: winget install ffmpeg

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

Especificaciones de Video

  • Formatos soportados: .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 duración e intervalo de cuadros

Comportamiento del Script

Validación Automática

El script valida automáticamente:

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

Aparecen mensajes de error claros con guías de 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): Medida de similitud a nivel de píxel (escala de 20-50 dB, más alto es mejor)

SSIM (Structural Similarity Index): Medida de similitud perceptual (escala 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 consistente (800px) para comparación, y los incrusta como URLs de datos base64 en un HTML autocontenido. Los archivos temporales se limpian 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 autocontenido (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 not found": Instala FFmpeg mediante el gestor de paquetes de la plataforma (ver sección de Requisitos)

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

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

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

Configuración

El script incluye constantes ajustables para límites de tamaño de archivo, timeouts, dimensiones de cuadro 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, resolució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 estilos

Individual skills in this repo

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

daymade/claude-code-skills

>- Generates Chinese/Japanese speech with StepFun's Contextual TTS — default stepaudio-2.5-tts, stepaudio-3-tts for whisper/inline-() prosody. Replaces step-tts-2's voice_label with natural-language instruction. Use for emotional/prosody-controlled synthesis, batch voice lines, migrating from step-tts-2, or cloned voices (2.5/step-tts-2, not v3). Triggers on 阶跃 TTS, 语音合成, 配音. Not for transcription (use stepfun-asr).

daymade/claude-code-skills

Download YouTube videos and HLS streams (m3u8) from platforms like Mux, Vimeo, etc. using yt-dlp and ffmpeg. Use this skill when users request downloading videos, extracting audio, handling protected streams with authentication headers, or troubleshooting download issues like nsig extraction failures, 403 errors, or cookie extraction problems.

daymade/local-conversation-history

Entry point for local AI conversation history across providers. Routes a request to the one skill that owns it, by platform (Claude Code, OpenAI Codex, Kimi CLI) and action (read evidence vs continue interrupted work), and owns the one job none of them own alone: a single inventory spanning all three providers. Use when the provider is unknown or plural ("our history", "what have I been working on", "which chats did I have"), when the user wants Kimi CLI history at all, when it is unclear whether they need evidence or resumption, or when they ask for this skill by name. Vague recall that names no platform ("we discussed this once, when was it?") belongs here rather than to a single-provider reader, because a Claude-only answer to an unscoped question cannot support an absence claim. When the platform and the action are both already clear, load that executor skill directly instead — except Kimi CLI, which has no reader or continuation skill of its own and always routes through here.

daymade/ppt-creator

Create professional slide decks from topics or documents. Generates structured content with data-driven charts, speaker notes, and complete PPTX files. Applies persuasive storytelling principles (Pyramid Principle, assertion-evidence). Supports multiple formats (Marp, PowerPoint). Use for presentations, pitches, slide decks, or keynotes.

daymade/prompt-optimizer

Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology. This skill should be used when users provide loose requirements, ambiguous feature descriptions, or need to enhance prompts for AI-generated code, products, or documents. Triggers include requests to "optimize my prompt", "improve this requirement", "make this more specific", or when raw requirements lack detail and structure.

daymade/qa-expert

This skill should be used when establishing comprehensive QA testing processes for any software project. Use when creating test strategies, writing test cases following Google Testing Standards, executing test plans, tracking bugs with P0-P4 classification, calculating quality metrics, or generating progress reports. Includes autonomous execution capability via master prompts and complete documentation templates for third-party QA team handoffs. Implements OWASP security testing and achieves 90% coverage targets.

daymade/read-claude-code-history

Reads, searches, and exports local Claude Code history without resuming work. Covers recent session inventory, exact session timelines, verbatim human input including queued mid-turn prompts, full-event keyword search, hybrid recall when wording changed, end-state triage, and deleted-file recovery across active Claude homes plus registered archives. Use whenever the user asks what they or Claude said, wants a Claude Code session ID or original context, remembers prior work vaguely, needs an old file from a transcript, or must prove what a Claude session contained before continuing it. Also owns the only Kimi CLI surface, via its Kimi inventory and search flags. For Codex history use read-codex-history; when the request names no platform at all or spans providers, start at local-conversation-history.

daymade/read-codex-history

Reads, searches, and exports local OpenAI Codex history without continuing the old task. Lists recent Codex sessions, extracts exact prompt-ledger inputs by Session, locates a rollout by verified session_meta identity, reconstructs one chronological user/assistant timeline with fork and compaction lineage, and performs bounded keyword search across live and archived rollouts. Use whenever the user asks what they told Codex, wants recent original inputs, a Codex Session ID, full prior context, fork ancestry, or evidence of what a Codex run did. For Claude Code history use read-claude-code-history.

daymade/twitter-reader

Fetch Twitter/X post content including long-form Articles with full images and metadata. Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media. Supports individual posts and X Articles (long-form content). Automatically downloads all images to local attachments folder and generates complete Markdown with proper image references. Preferred over Jina for X Articles with images.

Skills relacionados