Communitygithub.com

julioseru/ver-video

Visionner, écouter et analyser une vidéo (URL YouTube ou autre site, ou fichier local).

Qu'est-ce que ver-video ?

Cette compétence (skill) permet d'analyser en profondeur des vidéos, qu'elles proviennent d'une URL (YouTube, etc.) ou d'un fichier local. Elle offre une alternative puissante aux agents qui ne peuvent pas traiter nativement le contenu vidéo en convertissant la vidéo en une série de feuilles de photogrammes horodatés, alignées avec la transcription audio et les coupures de scène. Le script sous-jacent (`vervideo.py`) utilise un échantillonnage adaptatif pour capturer les images à chaque changement significatif, garantissant ainsi que les détails visuels importants ne sont pas manqués. L'utilisateur est guidé pas à pas : d'abord une vérification unique de l'environnement, puis le traitement de la vidéo avec des options de paramétrage (plage temporelle, sensibilité aux changements, langue de l'audio), et enfin la visualisation obligatoire de chaque feuille de photogrammes via l'outil Read de l'agent. La compétence peut également solliciter une deuxième opinion via Gemini si une clé API est fournie. Idéal pour l'analyse de tutoriels, de présentations de stratégies de trading, ou toute vidéo nécessitant une extraction minutieuse d'informations visuelles et audio.

Compatible avec~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/julioseru/ver-video/tree/HEAD/skills/ver-video

Demander à votre IA préférée

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

Documentation

Que fait ver-video ?

SKILL_DIR est le dossier qui contient ce fichier. Le script se trouve dans SKILL_DIR/scripts/vervideo.py. Sous Windows, utilisez py -3.12 (Whisper n'est pas encore compatible avec Python 3.14) ; sous macOS/Linux, python3.

1. Vérifier (uniquement la première fois dans la session)

py -3.12 "SKILL_DIR/scripts/vervideo.py" check

Si listo_para_watch est false, dites à l'utilisateur d'exécuter instalar_todo.bat (Windows) ou install.sh (macOS/Linux) de ce dépôt. N'installez rien avec les privilèges administrateur sans demander.

2. Traiter la vidéo

py -3.12 "SKILL_DIR/scripts/vervideo.py" watch "<URL ou chemin>"

Par défaut, utilise l'échantillonnage adaptatif : analyse la vidéo 4 fois par seconde et enregistre une image à chaque changement de l'image (y compris si une petite zone change : un texte, une étiquette de prix, une ligne dessinée), plus une image de contrôle toutes les ≤5 s si rien ne change. report.json liste les instants de changement (visual_events).

Options utiles :

  • --start 12:00 --end 18:30 pour une plage. Utilisez-les pour les vidéos longues : d'abord un passage général, puis des plages avec plus de détails.
  • --sensitivity 1 pour capturer des changements plus subtils (par défaut 2 %) ; --max-gap 3 pour plus d'images de contrôle dans les zones calmes.
  • --mode fixed --interval 2 pour l'ancien mode (une image toutes les N secondes).
  • --lang en si l'audio est en anglais (auto pour détecter).
  • --transcript subs pour utiliser uniquement les sous-titres du site (plus rapide) ; whisper pour forcer la transcription locale.
  • Whisper utilise le GPU NVIDIA s'il est disponible (modèle large-v3-turbo, plus précis) et sinon le CPU (modèle small). Forcez avec --whisper-model.

La commande imprime un JSON avec le chemin de timeline.md et le dossier de sortie.

3. Voir la vidéo (obligatoire, ne sautez pas cette étape)

  1. Lisez timeline.md en entier.
  2. Pour chaque feuille, dans l'ordre, ouvrez l'image avec Read et lisez-la en même temps que ce qui est dit dans cette plage. Chaque feuille contient 9 images (gauche→droite, haut→bas) avec l'heure en jaune dans une bande au-dessus de chacune (avec les dixièmes si elle ne tombe pas sur une seconde exacte) ; ✂ marque une coupure de scène. Les images NE sont PAS équidistantes : deux images consécutives très proches indiquent qu'à ce moment-là quelque chose a changé à l'écran.
  3. Prenez des notes mentales de ce qui change entre les images : mouvement, texte à l'écran, graphiques, niveaux de prix, indicateurs, gestes.
  4. Lorsque quelque chose d'important semble petit (un nombre, un niveau, le nom d'un indicateur, des paramètres), effectuez un zoom à pleine résolution :
py -3.12 "SKILL_DIR/scripts/vervideo.py" zoom "<dossier de sortie>" --at 14:32 --count 3 --step 1

et ouvrez les images renvoyées.

4. Répondre

  • Citez les horodatages [MM:SS] pour chaque affirmation.
  • Séparez ce qui se voit (images) de ce qui se dit (transcription). N'affirmez pas de faits visuels à partir uniquement de l'audio, ni l'inverse.
  • Si une partie n'est pas claire (par exemple, un mouvement rapide entre deux images), dites-le et examinez cette plage plus en détail : watch ... --start MM:SS --end MM:SS --sensitivity 1 --min-gap 0.25.
  • Pour les vidéos de trading : extrayez les règles d'entrée, de sortie, de stop, de gestion, de timeframe, d'instrument et d'indicateurs avec leurs paramètres, et signalez ce que l'auteur ne précise pas.

5. Optionnel : Gemini

S'il y a GEMINI_API_KEY, vous pouvez demander un second avis avec un modèle qui traite la vidéo et l'audio de manière native. Prévenez d'abord l'utilisateur : la vidéo est envoyée à Google (les fichiers locaux sont téléchargés puis supprimés à la fin).

py -3.12 "SKILL_DIR/scripts/vervideo.py" gemini "<URL ou chemin>" --prompt "question précise"

Comparez sa réponse avec vos propres feuilles ; ne la copiez pas sans vérification.

Skills associés