Communitygithub.com

Biznomad/agent-skills

Dieses Skill sollte verwendet werden, um zwei Videos zu vergleichen, Kompressionsergebnisse oder Qualitätsunterschiede zu analysieren. Es generiert interaktive HTML-Berichte mit Qualitätsmetriken (PSNR, SSIM) und bildgenauen visuellen Vergleichen. Wird ausgelöst, wenn Benutzer „Videos vergleichen“, „Videoqualität“, „Kompressionsanalyse“, „Vorher/Nachher-Kompression“ erwähnen oder eine Qualitätsbewertung komprimierter Videos anfordern.

Was ist agent-skills?

Dieses Skill ermöglicht den direkten Vergleich zweier Videos und die Erstellung eines eigenständigen, interaktiven HTML-Berichts, der die Ergebnisse einer Videokompression detailliert analysiert. Es ist besonders nützlich für Entwickler, die die Effizienz von Codecs, die Auswirkungen von Bitratenreduzierungen oder die allgemeine Qualitätseinbuße durch Kompression bewerten möchten. Das Skill extrahiert automatisch Videometadaten, berechnet die bewährten Qualitätsmetriken PSNR (Peak Signal-to-Noise Ratio) und SSIM (Structural Similarity Index) und erzeugt frame-genaue visuelle Vergleiche mit drei verschiedenen Ansichtsmodi: Schieberegler, nebeneinander und Raster. Der generierte HTML-Bericht ist in sich geschlossen und benötigt keinen Server – er kann offline geöffnet werden und bietet Zoom-Funktionen (50–200 %). Das Skill unterstützt verschiedene Videoformate (MP4, MOV, AVI, MKV, WebM) und setzt FFmpeg/FFprobe sowie Python 3.8+ voraus. Es validiert automatisch die Eingaben, verhindert Sicherheitsprobleme wie Pfadangriffe und gibt klare Fehlermeldungen, falls FFmpeg fehlt, Dateien zu groß sind oder Zeitüberschreitungen auftreten. Die Verarbeitungszeit liegt bei typischen Videos zwischen einer und zwei Minuten und kann über das Intervall für die Frameextraktion gesteuert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/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, der die Kompressionsergebnisse analysiert. Das Skript extrahiert Videometadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildgenaue visuelle Vergleiche mit drei Ansichtsmodi: Schieberegler, nebeneinander und Raster.

Wann dieses Skill verwendet werden sollte

Verwenden Sie dieses Skill, wenn:

  • Sie Original- und komprimierte Videos vergleichen möchten
  • Sie die Qualität und Effizienz einer Videokompression analysieren möchten
  • Sie die Leistung eines Codecs oder die Auswirkungen einer Bitratenreduzierung bewerten möchten
  • Benutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Kompressionsanalyse" oder "Vorher/Nachher-Kompression" erwähnen

Grundlegende Verwendung

Basiskommando

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

Erzeugt comparison.html mit:

  • Videoparametern (Codec, Auflösung, Bitrate, Dauer, Dateigröße)
  • Qualitätsmetriken (PSNR, SSIM, prozentuale Größen-/Bitratenreduktion)
  • Bildgenauem Vergleich (Standard: Frames in 5-Sekunden-Intervallen)

Kommandooptionen

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

# Benutzerdefiniertes Frame-Intervall (größer = weniger Frames, 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

Voraussetzungen

Systemabhängigkeiten

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

# 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 Type Hints, 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 Frame-Intervall

Skriptverhalten

Automatische Validierung

Das Skript validiert automatisch:

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

Bei fehlgeschlagener Validierung erscheinen klare Fehlermeldungen mit Anleitungen zur Behebung.

Qualitätsmetriken

Das Skript berechnet zwei Standard-Qualitätsmetriken:

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

SSIM (Structural Similarity Index): Wahrnehmungsbasierte Ähnlichkeitsmessung (Skala 0,0–1,0, höher ist besser)

Detaillierte Interpretationsskalen und Qualitätsschwellenwerte finden Sie in references/video_metrics.md.

Frameextraktion

Das Skript extrahiert Frames 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 einem eigenständigen HTML-Bericht ein. Temporäre Dateien werden nach der Verarbeitung automatisch gelöscht.

Ausgabebericht

Der generierte HTML-Bericht enthält:

  • Schieberegler-Modus: Ziehen, um Original vs. Komprimiert aufzudecken (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, funktioniert offline)

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 Voraussetzungen)

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

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

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

Konfiguration

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

Referenzmaterialien

Konsultieren Sie diese Dateien für detaillierte Informationen:

  • references/video_metrics.md: Interpretation der Qualitätsmetriken (PSNR/SSIM-Skalen, Kompressionsziele, Bitratenrichtlinien)
  • references/ffmpeg_commands.md: FFmpeg-Befehlsreferenz (Metadatenextraktion, Frameextraktion, Fehlerbehebung)
  • references/configuration.md: Skriptkonfigurationsoptionen und anpassbare Konstanten
  • assets/template.html: HTML-Berichtsvorlage zur Anpassung der Ansichtsmodi und des Stils

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.

Verwandte Skills