Claude Eye : analyse d'animation image par image
Vous ne pouvez pas regarder une vidéo, mais vous pouvez lire des images. Cette compétence transforme une vidéo en un ensemble d'images horodatées, vous demande de regarder chaque image et de noter ce que fait chaque élément animé, puis transforme ces observations en une chronologie qui montre exactement quand les choses se désynchronisent. Les bugs de timing dans les animations CSS/JS sont généralement de 100 à 300 ms, ce qui est trop rapide pour être vu à l'œil nu mais facile à repérer dans un tableau d'images.
Les scripts se trouvent dans le répertoire scripts/ à côté de ce fichier. Ils nécessitent seulement Node 18+ et ffmpeg/ffprobe, sans npm install. Ci-dessous, <skill> fait référence au répertoire de cette compétence.
1. Vérifier les prérequis
Exécutez ffmpeg -version. S'il manque, informez l'utilisateur et donnez la commande d'installation pour son OS (Windows : winget install Gyan.FFmpeg ou choco install ffmpeg ; macOS : brew install ffmpeg ; Linux : sudo apt install ffmpeg). L'utilisateur devra ouvrir un nouveau terminal ensuite. Ne l'installez pas vous-même sans demander.
2. Extraire les images
node <skill>/scripts/extract_frames.mjs <video> --fps 5 --out ./claude-eye-output [--start S] [--end S] [--width 960]
Cette commande écrit frames/frame_NNNN.png ainsi qu'un manifest.json qui fait correspondre chaque numéro d'image à son horodatage. Prenez toujours les horodatages depuis le manifeste, ne les calculez jamais de tête.
Économisez vos lectures d'images. Chaque image lue coûte du contexte, donc visez environ 40 images ou moins par passe :
- Clip court (moins de ~8 s) : 5 ips sur toute la durée convient.
- Clip plus long, ou vous ne savez pas où se situe le problème : faites d'abord une passe grossière (
--fps 1ou2sur toute la vidéo) pour trouver où les choses bougent. Puis extrayez uniquement cette fenêtre à une fréquence plus élevée (--start/--end,--fps 10-15) dans un répertoire--outséparé. Rapportez la passe fine. - Si l'utilisateur nomme un moment (« vers 3 secondes », « quand le titre apparaît »), allez directement à cette fenêtre.
La largeur par défaut de 960 px est suffisante pour juger de l'opacité et de la position. Utilisez une --width plus grande seulement si les éléments sont minuscules.
3. Lire les images et enregistrer les observations
Lisez les images dans l'ordre avec l'outil de lecture. Pour chaque image, notez chaque élément texte/UI visible qui est en train d'animer ou pourrait l'être : titres, sous-titres, boutons, images, spans en surbrillance, superpositions, etc.
Gardez les noms de sélecteurs stables d'une image à l'autre : choisissez un nom descriptif en kebab-case la première fois que vous voyez un élément (hero-title, subtitle, cta-button) et réutilisez exactement ce nom dans toutes les images suivantes. La chronologie relie les images par nom, donc hero-title dans une image et title dans la suivante deviennent deux éléments différents et l'analyse échoue. Incluez un élément à 0 % dès qu'il est apparu ou qu'il est connu pour exister. Cela rend les points « caché → transition entrante » visibles.
Pour chaque élément, estimez :
opacity_percent(0-100). Jugez-la par rapport à l'arrière-plan et par rapport à l'aspect totalement visible de l'élément dans les images suivantes. Comptez aussi les révélations partielles : un clip-path ou un masque dévoilé à 40 % compte comme 40.state: un dehidden(≤10 %),transitioning-in(croissant),visible(≥90 %),transitioning-out(décroissant). Comparez avec les images voisines pour distinguer « entrée » de « sortie ».- Optionnel :
has_gradient,has_bluretnotespour des choses comme le mouvement ("translateY ~20px au-dessus de la position finale"), l'échelle, la quantité de flou ou le changement de couleur. Le mouvement et l'échelle comptent autant que l'opacité, donc notez-les dansnotesquand vous les voyez.
Écrivez tout cela dans <out>/frames.json :
[
{
"frame": 1,
"elements": [
{ "selector": "hero-title", "opacity_percent": 0, "state": "hidden" },
{ "selector": "subtitle", "opacity_percent": 0, "state": "hidden" }
],
"overall_state": "pre-animation",
"observation": "Zone hero vide ; rien de rendu pour l'instant."
}
]
frame doit correspondre aux numéros d'image du manifeste. Les horodatages sont remplis à partir du manifeste. Pour les longues séquences, écrivez le fichier par morceaux au fur et à mesure plutôt que de garder 40 images en mémoire.
L'opacité provenant d'une vidéo compressée est approximative. Une différence de ±10 % entre les images est du bruit ; une tendance sur plusieurs images constitue le signal.
4. Construire le rapport
node <skill>/scripts/build_report.mjs ./claude-eye-output --context "ce que l'animation est censée faire"
Cette commande produit report.md (résumé, tableau de chronologie des opacités, timing par élément, points de transition, événements de désynchronisation, observations) et analysis.json. Une désynchronisation est une image où certains éléments sont totalement visibles tandis que d'autres sont encore en transition, avec un écart d'opacité supérieur à 40 points entre eux. Utilisez --spread N pour rendre ce seuil plus strict ou plus souple.
5. Interpréter : c'est là que vous ajoutez de la valeur
Le script trouve quand les choses se produisent. Votre travail consiste à dire pourquoi et quoi modifier :
- Remplacez la section
<!-- RECOMMENDATIONS -->dereport.mdpar des conclusions spécifiques. Lisez le tableau de timing des éléments : par exemple, «subtitlecommence 200 ms aprèshero-titleet atteint l'opacité totale 400 ms plus tard, ce qui indique une durée plus longue associée à un délai. » Convertissez les écarts d'images en millisecondes en utilisant l'espacement entre images (1/ips). - Si le code source de l'utilisateur est disponible, trouvez le CSS/JS pour ces éléments (
transition,animation,@keyframes,transition-delay, configurations framer-motion/GSAP) et pointez vers les lignes exactes qui expliquent le timing observé. Proposez la correction concrète. - Mentionnez votre précision de timing (±1 image = ±1/ips s). Si une conclusion dépend d'un écart inférieur à une image, réextrayez cette fenêtre à une fréquence plus élevée avant de l'affirmer.
Ensuite, donnez à l'utilisateur un court résumé dans le chat : ce qui anime, les timings clés, chaque désynchronisation avec son horodatage et sa cause probable, et la correction. Incluez le chemin vers report.md.
Pas seulement l'opacité
Le pipeline du rapport est construit autour de l'opacité/visibilité, mais la même approche de lecture d'images fonctionne pour d'autres questions, comme un décalage de mise en page, un saut d'élément, un scintillement (une image avec un état erroné), un loader qui tourne alors qu'il ne devrait pas, ou une animation qui semble linéaire. Dans ces cas, extrayez toujours les images et lisez-les. Vous pouvez sauter build_report.mjs et répondre directement avec des horodatages référencés par image depuis le manifeste.