Communitygithub.com

daymade/claude-code-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 l'utilisateur mentionne « comparer des vidéos », « qualité vidéo », « analyse de compression », « avant/après compression » ou demande une évaluation de la qualité de vidéos compressées.

Qu'est-ce que claude-code-skills ?

Cette compétence permet de comparer deux fichiers vidéo (originale et compressée) et de générer un rapport HTML interactif complet pour analyser la qualité de la compression vidéo. Elle est utile pour les développeurs travaillant avec du contenu vidéo, les ingénieurs qualité, ou toute personne souhaitant évaluer l'impact d'un codec, d'un débit binaire ou d'une réduction de taille sur la qualité perçue. La compétence prend en charge les formats vidéo courants (.mp4, .mov, .avi, .mkv, .webm) et calcule automatiquement des métriques objectives de qualité : le PSNR (rapport signal sur bruit de crête) et le SSIM (indice de similarité structurelle). Elle extrait des images clés à intervalles réguliers (par défaut toutes les 5 secondes) et génère un rapport HTML autonome avec trois modes de visualisation : curseur coulissant, côte à côte, et grille. Le script effectue des validations automatiques (présence de FFmpeg, tailles de fichiers, extensions) et gère les erreurs courantes avec des messages explicites. Il est conçu pour fonctionner avec Python 3.8+ et nécessite FFmpeg/FFprobe installés sur le système. Le rapport généré est entièrement contenu dans un seul fichier HTML, ne nécessite pas de serveur, et peut être visualisé hors ligne. Les cas d'utilisation typiques incluent : l'évaluation de la qualité après compression vidéo, la comparaison de performances entre codecs, l'analyse de l'impact des réglages de débit binaire, ou la vérification visuelle de la fidélité d'une vidéo compressée par rapport à l'originale.

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

Video Comparer

Présentation

Compare deux vidéos et génère 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 d'affichage : curseur, côte à côte et grille.

Quand utiliser cette compétence

Utilisez cette compétence lorsque :

  • Vous comparez une vidéo originale et une vidéo compressée
  • 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 originale.mp4 compressee.mp4

Génère comparaison.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)
  • Comparaison image par image (par défaut : images toutes les 5 secondes)

Options de commande

# Fichier de sortie personnalisé
python3 scripts/compare.py originale.mp4 compressee.mp4 -o rapport.html

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

# Comparaison par lots
for originale in originales/*.mp4; do
    compressee="compressees/$(basename "$originale")"
    sortie="rapports/$(basename "$originale" .mp4).html"
    python3 scripts/compare.py "$originale" "$compressee" -o "$sortie"
done

Prérequis

Dépendances système

FFmpeg et FFprobe (nécessaires 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 : environ 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 validation.

Métriques de qualité

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

PSRN (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 les échelles d'interprétation détaillées et les seuils de qualité, consultez references/video_metrics.md.

Extraction d'images

Le script extrait des images à intervalles spécifiés (par défaut : 5 secondes), les met à l'échelle à une hauteur constante (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 supprimés après le traitement.

Rapport de sortie

Le rapport HTML généré comprend :

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

Détails importants de mise en œuvre

Sécurité

Le script implémente :

  • Validation des chemins (chemins absolus, empêche le parcours de répertoires)
  • Prévention des injections 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 --intervalle plus grande (traite moins d'images)

« Non-correspondance 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 des images 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 d'affichage et le style

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