Communitygithub.com

Biznomad/agent-skills

Cette compétence doit être utilisée pour comparer deux vidéos afin d'analyser les résultats de compression ou les différences de qualité. Elle génère des rapports HTML interactifs avec des métriques de qualité (PSNR, SSIM) et des comparaisons visuelles image par image. Elle se déclenche lorsque les utilisateurs mentionnent « comparer des vidéos », « qualité vidéo », « analyse de compression », « avant/après compression » ou demandent une évaluation de qualité de vidéos compressées.

Qu'est-ce que agent-skills ?

Cette compétence permet de comparer deux fichiers vidéo et de générer un rapport HTML interactif détaillant les résultats de compression. Elle extrait les métadonnées vidéo, calcule les métriques de qualité standard (PSNR et SSIM) et crée une comparaison visuelle image par image avec trois modes de visualisation : curseur, côte à côte et grille. Elle prend en charge plusieurs formats vidéo (MP4, MOV, AVI, MKV, WEBM) et nécessite FFmpeg/FFprobe ainsi que Python 3.8+. La compétence inclut une validation automatique, une gestion des erreurs complète, et génère un rapport autonome fonctionnant hors ligne. Elle est particulièrement utile pour les ingénieurs vidéo et les développeurs qui souhaitent analyser l'impact des paramètres de compression, évaluer les performances des codecs ou les réductions de débit binaire, et est compatible avec des outils comme Claude Code, Cursor ou Codex.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Comparateur vidéo

Aperçu

Comparez deux vidéos et générez un rapport HTML interactif analysant les résultats de compression. Le script extrait les métadonnées vidéo, calcule les métriques de qualité (PSNR, SSIM) et crée des comparaisons visuelles image par image avec trois modes de visualisation : curseur, côte à côte et grille.

Quand utiliser cette compétence

Utilisez cette compétence lorsque :

  • Vous comparez des vidéos originales et compressées
  • Vous analysez la qualité et l'efficacité de la compression vidéo
  • Vous évaluez les performances d'un codec ou l'impact d'une réduction de débit binaire
  • Les utilisateurs mentionnent « comparer des vidéos », « qualité vidéo », « analyse de compression » ou « avant/après compression »

Utilisation principale

Commande de base

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

Génère comparison.html avec :

  • Paramètres vidéo (codec, résolution, débit binaire, durée, taille du fichier)
  • Métriques de qualité (PSNR, SSIM, pourcentages de réduction de taille/débit binaire)
  • Comparaison image par image (par défaut : images toutes les 5 secondes)

Options de commande

# Fichier de sortie personnalisé
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# Intervalle d'images personnalisé (plus grand = moins d'images, traitement plus rapide)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# Comparaison par lots
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

Prérequis

Dépendances système

FFmpeg et FFprobe (requis pour l'analyse vidéo et l'extraction d'images) :

# macOS
brew install ffmpeg

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

# Windows
# Télécharger depuis https://ffmpeg.org/download.html
# Ou utiliser : winget install ffmpeg

Python 3.8+ (utilise les indications de type, les f-strings, pathlib)

Spécifications vidéo

  • Formats pris en charge : .mp4 (recommandé), .mov, .avi, .mkv, .webm
  • Limite de taille de fichier : 500 Mo par vidéo (configurable)
  • Temps de traitement : ~1-2 minutes pour des vidéos typiques ; varie selon la durée et l'intervalle d'images

Comportement du script

Validation automatique

Le script valide automatiquement :

  • L'installation et la disponibilité de FFmpeg/FFprobe
  • L'existence des fichiers, les extensions et les limites de taille
  • La sécurité des chemins (empêche le parcours de répertoires)

Des messages d'erreur clairs avec des conseils de résolution apparaissent en cas d'échec de la validation.

Métriques de qualité

Le script calcule deux métriques de qualité standard :

PSNR (Peak Signal-to-Noise Ratio) : Mesure de similarité au niveau des pixels (échelle de 20 à 50 dB, plus élevé est meilleur)

SSIM (Structural Similarity Index) : Mesure de similarité perceptuelle (échelle de 0,0 à 1,0, plus élevé est meilleur)

Pour des échelles d'interprétation détaillées et des seuils de qualité, consultez references/video_metrics.md.

Extraction d'images

Le script extrait des images à des intervalles spécifiés (par défaut : 5 secondes), les redimensionne à une hauteur cohérente (800 pixels) pour la comparaison, et les intègre sous forme d'URL de données base64 dans un rapport HTML autonome. Les fichiers temporaires sont automatiquement nettoyés après le traitement.

Rapport de sortie

Le rapport HTML généré comprend :

  • Mode curseur : Faites glisser pour révéler l'original vs le compressé (par défaut)
  • Mode côte à côte : Affichage simultané pour une comparaison directe
  • Mode grille : Disposition compacte sur 2 colonnes
  • Contrôles de zoom : Grossissement de 50 % à 200 %
  • Format autonome (aucun serveur requis, fonctionne hors ligne)

Détails d'implémentation importants

Sécurité

Le script implémente :

  • Validation des chemins (chemins absolus, empêche le parcours de répertoires)
  • Prévention d'injection de commandes (pas de shell=True, arguments validés)
  • Limites de ressources (taille de fichier, délais d'attente)
  • Exceptions personnalisées : ValidationError, FFmpegError, VideoComparisonError

Scénarios d'erreur courants

« FFmpeg introuvable » : Installez FFmpeg via le gestionnaire de paquets de votre plateforme (voir la section Prérequis)

« Fichier trop volumineux » : Compressez les vidéos avant la comparaison, ou ajustez MAX_FILE_SIZE_MB dans scripts/compare.py

« L'opération a expiré » : Augmentez la constante FFMPEG_TIMEOUT ou utilisez une valeur --interval plus grande (traite moins d'images)

« Non-concordance du nombre d'images » : Les vidéos ont des durées/taux d'images différents ; le script tronque automatiquement au nombre d'images minimum et affiche un avertissement

Configuration

Le script inclut des constantes ajustables pour les limites de taille de fichier, les délais d'attente, les dimensions d'image et les intervalles d'extraction. Pour personnaliser le comportement, modifiez les constantes en haut de scripts/compare.py. Pour des options de configuration détaillées et leurs impacts, consultez references/configuration.md.

Documents de référence

Consultez ces fichiers pour des informations détaillées :

  • references/video_metrics.md : Interprétation des métriques de qualité (échelles PSNR/SSIM, cibles de compression, directives de débit binaire)
  • references/ffmpeg_commands.md : Référence des commandes FFmpeg (extraction de métadonnées, extraction d'images, dépannage)
  • references/configuration.md : Options de configuration du script et constantes ajustables
  • assets/template.html : Modèle de rapport HTML pour personnaliser les modes de visualisation et le style

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 associés