Communitygithub.com

Analyseur de vidéos courtes

Décompose la structure, l'accroche, le rythme et le montage d'une vidéo courte (Reel, TikTok ou Short) que l'utilisateur aime, puis réutilise cette structure pour écrire une nouvelle vidéo sur son propre sujet et découper ses rushes en un montage brut.

Qu'est-ce que Analyseur de vidéos courtes ?

Cette compétence permet à un agent IA d'analyser en profondeur une vidéo courte (Reel Instagram, TikTok, YouTube Shorts ou X) à partir d'un lien ou d'un fichier local. Elle extrait la transcription, mesure le nombre de plans, leur durée et le rythme de parole, puis génère un rapport détaillé (breakdown.md) couvrant l'accroche, la structure narrative, le pacing et les techniques de montage. L'agent peut ensuite rédiger un script original sur un sujet donné par l'utilisateur, en respectant la même structure que la vidéo de référence, avec un plan de tournage détaillé. Enfin, lorsque l'utilisateur importe ses rushes, la compétence sélectionne les meilleures prises et assemble un montage brut (rough-cut.mp4) avec sous-titres mot à mot, en cadrant le visage en 9:16. L'ensemble fonctionne localement via des scripts Python et FFmpeg, sans dépendance à un service cloud.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/corbinsylk/analyzer-skill/tree/HEAD/skills/analyzer

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 Analyseur de vidéos courtes ?

Donnez-lui un Reel que vous aimez et il décompose l'accroche, le rythme et le montage. Ensuite, il réutilise la même structure pour construire une vidéo autour de votre sujet.

Tout s'exécute sur cet ordinateur. Les outils se trouvent dans ~/.claude/skills/analyzer/scripts/ et s'exécutent avec le Python de la compétence : ~/.claude/skills/analyzer/.venv/bin/python (ci-dessous : PY = ce chemin, AN = ~/.claude/skills/analyzer/scripts).

0. Vérifier l'installation (à chaque exécution)

test -x ~/.claude/skills/analyzer/.venv/bin/python && command -v ffmpeg

Si l'un des deux manque, informez l'utilisateur en une ligne et lancez l'installateur : bash ~/analyzer-skill/install.sh, ou clonez-le d'abord : git clone https://github.com/corbinsylk/analyzer-skill ~/analyzer-skill && bash ~/analyzer-skill/install.sh.

1. Récupérer la vidéo

Un lien (Instagram, TikTok, YouTube Shorts, X) ou un fichier. Ensuite :

PY AN/fetch.py "<lien ou fichier>"

Le script affiche le chemin de la vidéo sur sa dernière ligne (les téléchargements atterrissent dans ~/Movies/Analyzer/). Les publications publiques se téléchargent sans connexion. Si le téléchargement échoue (privé, restriction d'âge, supprimé), dites à l'utilisateur de télécharger ou d'enregistrer l'écran et de faire glisser le fichier.

2. Mesurer la vidéo

PY AN/transcribe.py "<vidéo>"
PY AN/shots.py "<vidéo>"

Les deux scripts utilisent le dossier de travail <nom vidéo>-analysis/ à côté de la vidéo. transcribe.py produit transcript.md et words.json (chaque mot avec son horodatage ; une astuce de vitesse sur "mps" au premier lancement est inoffensive). shots.py produit pacing.md (tous les nombres ci-dessous, plus un tableau plan par plan avec ce qui est dit sur chaque plan), des planches contact sheet-N.jpg (petites, numérotées, pour la vue d'ensemble) et shots/NN.jpg (une image par plan à 720 de large, assez grande pour lire le texte à l'écran ; pour les plans longs, aussi NN-a/NN-b, leur premier et dernier instant). Si shots.py trouve beaucoup moins de plans que la vidéo n'en a visiblement, relancez avec --threshold 0.18 ; s'il divise un plan en plusieurs (mouvement rapide, flashs), utilisez --threshold 0.4.

3. Observer, puis rédiger l'analyse

Lisez transcript.md et pacing.md. Ouvrez chaque planche contact pour la vue d'ensemble, puis ouvrez les images shots/NN.jpg des plans des 3 premières secondes et de tout plan où quelque chose change (apparition de texte, zoom, graphique, nouveau lieu) : il n'est pas nécessaire de toutes les ouvrir. Vous ne pouvez pas entendre la vidéo : ne dites rien sur la musique ou les effets sonores au-delà de ce que montre la transcription. La transcription peut mal entendre les noms et termes (un sport, une marque, un plat) : vérifiez-les par rapport au texte à l'écran et utilisez l'orthographe correcte dans ce que vous écrivez.

Écrivez <dossier de travail>/breakdown.md avec les sections suivantes, chaque affirmation liée à un horodatage ou un numéro de plan :

  1. L'accroche (0-3 s). Les mots exacts, ce qui est à l'écran (cadrage, texte à l'écran et sa position, mouvement), le nombre de cuts, et pourquoi elle arrête le défilement : la lacune de curiosité, la promesse, la rupture de schéma.
  2. La structure. Les séquences dans l'ordre avec leurs horodatages : accroche, mise en place ou problème, les retournements, le dénouement, l'appel à l'action. Pour chaque séquence : son rôle, sa durée en secondes et en mots, et la ligne qui remplit ce rôle.
  3. Le rythme. Les chiffres de pacing.md (nombre de plans, durée moyenne et médiane des plans, cuts dans les 3 premières secondes, mots par minute) et ce qu'ils signifient. Pour compter les mots d'une séquence : PY AN/words.py "<dossier de travail>" <début> <fin> (secondes ou minutes:secondes) ; il affiche le nombre de mots, le rythme et les mots : où ça accélère, où ça ralentit, comment le rythme des cuts suit l'histoire.
  4. Le montage. Cadrage et caméra (quelle portion du cadre le visage occupe, zooms, changements d'angle : à l'œil depuis les images), texte à l'écran (style, taille, position, moment d'apparition), sous-titres (style, combien de mots à la fois), images d'illustration, enregistrements d'écran, graphiques, transitions.
  5. La formule. La structure sous forme de modèle à remplir que n'importe qui pourrait réutiliser : chaque séquence sous forme [ce qui va ici] avec sa durée cible, son nombre de mots et son geste de montage.

Ensuite, dites à l'utilisateur l'accroche, la formule et les trois choses qui font que ça marche, en quelques lignes, et pointez vers breakdown.md.

4. Refaire la vidéo sur le sujet de l'utilisateur

Posez une question s'il ne l'a pas déjà dit : "Quel sujet (et pour quel public) dois-je construire la nouvelle vidéo ?" Ensuite, écrivez <dossier de travail>/remake.md :

  • Le script, mot pour mot, séquence par séquence, dans la même structure, chaque séquence à environ 10 % près du nombre de mots de la référence (depuis words.py), pour qu'elle dure la même longueur au même rythme. L'accroche utilise le même mécanisme que la référence (le même type de promesse, de chiffre, de question ou de rupture de schéma), jamais ses mots. Si l'utilisateur vous a dit comment il parle (un fichier de voix ou de marque, des scripts précédents dans ce projet, ses propres instructions), écrivez dans cette voix ; sinon, un style simple, direct et parlé, comme les gens parlent à la caméra.
  • Le plan de tournage : pour chaque séquence, quoi filmer (cadrage, où regarder, gestes, accessoires ou lieux), et le geste de montage à ce moment-là, repris de la référence (un cut, un zoom avant, du texte à l'écran avec ses mots exacts, une image d'illustration à montrer).
  • Le texte à l'écran listé séparément, avec son horodatage.
  • Notes de tournage : dites chaque ligne deux fois pour pouvoir choisir la meilleure prise ; faites une pause d'une seconde entre les lignes.

5. Montage brut (quand l'utilisateur a filmé)

Lorsque l'utilisateur fait glisser ses rushes du remake :

PY AN/transcribe.py "<rushes>"

Lisez le transcript.md et words.json des rushes. Pour chaque ligne du script, choisissez la meilleure prise propre (complète, sans hésitation ; généralement la dernière), puis écrivez <dossier de travail des rushes>/keep.json, dans l'ordre du script :

[{"line": "la ligne du script", "start": 12.40, "end": 15.92}]

start = le s du premier mot de la prise, end = le e du dernier mot, depuis words.json. Ensuite :

PY AN/rough_cut.py "<rushes>" "<dossier de travail des rushes>"

Le script coupe chaque prise serrée sur ses bords de mots, cadre en 9:16 sur le visage, les assemble dans l'ordre avec des sous-titres mot à mot, et écrit rough-cut.mp4 plus rough-cut.jpg (8 images réparties sur la vidéo). Ouvrez le jpg et vérifiez que le visage est bien cadré et que les sous-titres se lisent. Dites à l'utilisateur ce qui est dans le montage brut et quels gestes de montage du plan de tournage il doit encore ajouter dans son éditeur (texte, zooms, images d'illustration).

Skills associés