Communitygithub.com

IGTA-Tech/claude-skills-research

Dieses Skill sollte verwendet werden, um zwei Videos zu vergleichen, z. B. zur Analyse von Komprimierungsergebnissen oder Qualitätsunterschieden. Es generiert interaktive HTML-Berichte mit Qualitätsmetriken (PSNR, SSIM) und bildweisen visuellen Vergleichen. Wird ausgelöst, wenn Nutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Komprimierungsanalyse", "Vorher/Nachher-Komprimierung" erwähnen oder eine Qualitätsbewertung von komprimierten Videos anfordern.

Was ist claude-skills-research?

Dieses Skill ermöglicht den detaillierten Vergleich zweier Videodateien, wobei ein interaktiver HTML-Bericht mit Qualitätsmetriken (PSNR, SSIM) und bildgenauen visuellen Vergleichen erstellt wird. Es ist ideal für Entwickler und Ingenieure, die die Auswirkungen von Videokomprimierung, Codec-Leistung oder Bitratenreduzierung analysieren möchten. Das Skill unterstützt gängige Videoformate wie MP4, MOV, AVI, MKV und Webm und erfordert FFmpeg/FFprobe sowie Python 3.8+. Es bietet drei Anzeigemodi (Schieberegler, nebeneinander, Raster) sowie Zoom-Funktionen, und der Bericht ist in sich geschlossen und offline nutzbar. Die Skriptvalidierung umfasst Sicherheitsprüfungen (Pfad- und Befehlsinjektionsschutz) und automatische Bereinigung temporärer Dateien.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGTA-Tech/claude-skills-research/tree/HEAD/claude-code-skills/video-comparer

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Video-Comparer

Übersicht

Vergleichen Sie zwei Videos und generieren Sie einen interaktiven HTML-Bericht zur Analyse der Komprimierungsergebnisse. Das Skript extrahiert Video-Metadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildweise visuelle Vergleiche mit drei Anzeigemodi: Schieberegler, nebeneinander und Raster.

Wann dieses Skill verwendet werden sollte

Verwenden Sie dieses Skill, wenn:

  • Original- und komprimierte Videos verglichen werden sollen
  • Die Qualität und Effizienz der Videokomprimierung analysiert werden soll
  • Die Leistung eines Codecs oder die Auswirkungen einer Bitratenreduzierung bewertet werden soll
  • Nutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Komprimierungsanalyse" oder "Vorher/Nachher-Komprimierung" erwähnen

Kernnutzung

Basiskommando

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

Generiert comparison.html mit:

  • Videoparametern (Codec, Auflösung, Bitrate, Dauer, Dateigröße)
  • Qualitätsmetriken (PSNR, SSIM, Größen-/Bitratenreduzierung in Prozent)
  • Bildweiser Vergleich (Standard: Bilder in 5-Sekunden-Intervallen)

Kommandooptionen

# Benutzerdefinierte Ausgabedatei
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# Benutzerdefiniertes Bildintervall (größer = weniger Bilder, schnellere Verarbeitung)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# Batch-Vergleich
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

Anforderungen

Systemabhängigkeiten

FFmpeg und FFprobe (erforderlich für Videoanalyse und Bildextraktion):

# macOS
brew install ffmpeg

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

# Windows
# Herunterladen von https://ffmpeg.org/download.html
# Oder verwenden: winget install ffmpeg

Python 3.8+ (verwendet Typannotationen, f-Strings, pathlib)

Videospezifikationen

  • Unterstützte Formate: .mp4 (empfohlen), .mov, .avi, .mkv, .webm
  • Dateigrößenlimit: 500 MB pro Video (konfigurierbar)
  • Verarbeitungszeit: ~1-2 Minuten für typische Videos; variiert je nach Dauer und Bildintervall

Skriptverhalten

Automatische Validierung

Das Skript validiert automatisch:

  • Installation und Verfügbarkeit von FFmpeg/FFprobe
  • Dateiexistenz, Erweiterungen und Größenlimits
  • Pfadsicherheit (verhindert Directory Traversal)

Klare Fehlermeldungen mit Lösungshinweisen erscheinen bei fehlgeschlagener Validierung.

Qualitätsmetriken

Das Skript berechnet zwei Standard-Qualitätsmetriken:

PSNR (Peak Signal-to-Noise Ratio): Pixelgenaue Ähnlichkeitsmessung (20-50 dB-Skala, höher ist besser)

SSIM (Structural Similarity Index): Wahrnehmungsbezogene Ähnlichkeitsmessung (0.0-1.0-Skala, höher ist besser)

Eine detaillierte Interpretation der Skalen und Qualitätsschwellenwerte finden Sie in references/video_metrics.md.

Bildextraktion

Das Skript extrahiert Bilder in festgelegten Intervallen (Standard: 5 Sekunden), skaliert sie auf eine einheitliche Höhe (800 Pixel) für den Vergleich und bettet sie als base64-Daten-URLs in das eigenständige HTML ein. Temporäre Dateien werden nach der Verarbeitung automatisch bereinigt.

Ausgabebericht

Der generierte HTML-Bericht enthält:

  • Schieberegler-Modus: Ziehen, um Original vs. Komprimiert anzuzeigen (Standard)
  • Nebeneinander-Modus: Gleichzeitige Anzeige für direkten Vergleich
  • Raster-Modus: Kompaktes 2-Spalten-Layout
  • Zoom-Steuerung: 50%-200% Vergrößerung
  • Eigenständiges Format (kein Server erforderlich, offline nutzbar)

Wichtige Implementierungsdetails

Sicherheit

Das Skript implementiert:

  • Pfadvalidierung (absolute Pfade, verhindert Directory Traversal)
  • Schutz vor Befehlsinjektion (kein shell=True, validierte Argumente)
  • Ressourcenlimits (Dateigröße, Timeouts)
  • Benutzerdefinierte Ausnahmen: ValidationError, FFmpegError, VideoComparisonError

Häufige Fehlerszenarien

"FFmpeg nicht gefunden": Installieren Sie FFmpeg über den Paketmanager Ihrer Plattform (siehe Abschnitt Anforderungen)

"Datei zu groß": Komprimieren Sie Videos vor dem Vergleich oder passen Sie MAX_FILE_SIZE_MB in scripts/compare.py an

"Vorgang abgelaufen (Timeout)": Erhöhen Sie die Konstante FFMPEG_TIMEOUT oder verwenden Sie einen größeren Wert für --interval (verarbeitet weniger Bilder)

"Bildanzahl stimmt nicht überein": Videos haben unterschiedliche Dauern/Bildraten; das Skript kürzt automatisch auf die minimale Bildanzahl und zeigt eine Warnung an

Konfiguration

Das Skript enthält anpassbare Konstanten für Dateigrößenlimits, Timeouts, Bildabmessungen und Extraktionsintervalle. Um das Verhalten anzupassen, bearbeiten Sie die Konstanten am Anfang von scripts/compare.py. Detaillierte Konfigurationsoptionen und ihre Auswirkungen finden Sie in references/configuration.md.

Referenzmaterialien

Konsultieren Sie diese Dateien für detaillierte Informationen:

  • references/video_metrics.md: Interpretation von Qualitätsmetriken (PSNR/SSIM-Skalen, Komprimierungsziele, Bitratenrichtlinien)
  • references/ffmpeg_commands.md: FFmpeg-Befehlsreferenz (Metadatenextraktion, Bildextraktion, Fehlerbehebung)
  • references/configuration.md: Skript-Konfigurationsoptionen und anpassbare Konstanten
  • assets/template.html: HTML-Berichtsvorlage zur Anpassung von Anzeigemodi und Styling

Individual skills in this repo

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

IGTA-Tech/claude-skills-research

Use when localizing apps, using String Catalogs, generating type-safe symbols (Xcode 26+), handling plurals, RTL layouts, locale-aware formatting, or migrating from .strings files - comprehensive i18n patterns for Xcode 15-26

IGTA-Tech/claude-skills-research

Use when implementing SwiftUI animations, understanding VectorArithmetic, using @Animatable macro, choosing between spring and timing curve animations, or debugging animation behavior - comprehensive animation reference from iOS 13 through iOS 26

IGTA-Tech/claude-skills-research

Use when CAAnimation completion handler doesn't fire, spring physics look wrong on device, animation duration mismatches actual time, gesture + animation interaction causes jank, or timing differs between simulator and real hardware - systematic CAAnimation diagnosis with CATransaction patterns, frame rate awareness, and device-specific behavior

IGTA-Tech/claude-skills-research

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.

IGTA-Tech/claude-skills-research

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.

IGTA-Tech/claude-skills-research

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

IGTA-Tech/claude-skills-research

Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.

Verwandte Skills