Communitygithub.com

ever-just/agentskills

Optimisez et intégrez une vidéo existante en fond héro, arrière-plan ou boucle, rapide, net et en lecture automatique sur un site web.

Qu'est-ce que agentskills ?

Cette compétence transforme une vidéo source (capture d’écran, export HEVC, etc.) en une séquence optimisée pour le web, avec lecture automatique fiable sur tous les navigateurs et appareils, y compris Safari et mobile. Elle transcode la vidéo au format H.264 avec le bon espace colorimétrique (yuv420p), active le démarrage rapide (faststart), applique un redimensionnement adapté à la rétine (scale=1600:-2) et génère une image poster. Le résultat est une vidéo plus légère, nette et compatible. Après transcodage, la compétence intègre la vidéo dans une balise HTML `<video>` avec les attributs `autoplay`, `muted`, `loop` et `playsinline`, et vérifie la lecture réelle via [[cdp-render-verification]]. Elle est destinée aux développeurs utilisant des agents IA comme Claude Code, Cursor ou Codex, et s’applique aux contextes Odoo (stockage en pièce jointe `ir.attachment`) ou tout site web utilisant des ressources statiques. Pour la création ou l’animation de vidéos, utiliser plutôt [[remotion]], [[moviepy]] ou [[motion-canvas]].

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ever-just/agentskills/tree/HEAD/skills/web-embed-video-optimization

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

Documentation

Optimisation vidéo pour intégration web

Transformez un clip source (enregistrement d'écran, export téléphone, rendu HEVC) en une vidéo rapide, nette et fiable en lecture automatique pour l'intégrer en tant que héros/fond/boucle. Le gain est généralement important : un H.264 adapté à la rétine avec un CRF raisonnable fait passer un enregistrement d'écran 1080p d'environ ~8 Mo à ~1,5 Mo sans perte visible, et corrige les problèmes de lecture automatique et de codec.

Pour créer ou animer une vidéo, utilisez plutôt [[remotion]] / [[moviepy]] / [[motion-canvas]] — cette compétence optimise des séquences que vous possédez déjà.

Quand l'utiliser

  • Ajout/remplacement d'une vidéo héros, de fond ou de démo en boucle sur un site.
  • La vidéo est trop lourde, ne se lance pas automatiquement (mobile/Safari), présente des erreurs de codec ou semble floue.

Recette

1. Sondez d'abord

ffprobe -v error -select_streams v:0 \
  -show_entries stream=codec_name,width,height,r_frame_rate,duration,pix_fmt,profile \
  -of default=noprint_wrappers=1 in.mp4
ffprobe -v error -select_streams a -show_entries stream=codec_name -of csv=p=0 in.mp4   # audio ?
# Vérification faststart : 'moov' est-il avant 'mdat' ? (moov à la fin = démarrage lent)

2. Transcodez (compatible web + rétine)

ffmpeg -y -i in.mp4 -vf "scale=1600:-2" \
  -c:v libx264 -profile:v high -pix_fmt yuv420p -crf 23 -preset slow \
  -movflags +faststart -an -r 30 out.mp4
  • -pix_fmt yuv420p — obligatoire pour Safari et une large compatibilité (yuv444/422 ne sont pas lus).
  • -movflags +faststart — déplace l'atome moov au début pour que la lecture commence avant le téléchargement complet. Sans cela, un héros en lecture automatique s'arrête sur les connexions lentes.
  • -an — supprime l'audio ; une boucle de fond muette n'en a jamais besoin (fichier plus léger).
  • scale=1600:-2 — encode à environ 2× la largeur d'affichage CSS, pas la résolution native 1080p/4K. Pour un cadre ≤820px, 1600px est net sur rétine et beaucoup plus léger. -2 garde une hauteur paire (requis par H.264).
  • -crf 23 -preset slow — haute qualité, bonne compression. Le contenu d'écran/UI se compresse particulièrement bien ; augmentez CRF à 25–26 seulement si le fichier reste lourd.

3. Image d'affiche

ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg

Choisissez un moment représentatif (-ss), pas une image d'introduction vide.

4. Intégrez

<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
  <source src="/path/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay sont tous nécessaires pour la lecture automatique sur mobile.
  • CSS du conteneur : video{display:block;width:100%;height:auto} permet à un clip 16:9 de définir sa propre hauteur ; enveloppez-le dans un cadre avec overflow:hidden;border-radius.

5. Servez (tenants Odoo)

Stockez comme ir.attachment public et référencez /web/content/<id> (vidéo) et /web/image/<id> (affiche) — voir [[everjust-website-customization]]. Transférez le binaire via docker cp (le shell s'exécute dans le conteneur). Utilisez des ID d'attachement frais et pointez la vue, plutôt que d'écraser des anciens IDs, pour éviter le cache périmé du navigateur/CDN. Les modifications de vue nécessitent un redémarrage du conteneur pour s'afficher.

Vérification (obligatoire)

Confirmez que la vidéo se lance réellement avec [[cdp-render-verification]] — lancez Chrome avec --autoplay-policy=no-user-gesture-required, puis lisez l'élément <video> :

  • readyState === 4 (HAVE_ENOUGH_DATA), paused === false, currentTime > 0 après une courte attente (en progression), et videoWidth/videoHeight correspondent à l'encodage.
  • Vérifiez bureau et mobile, et que la page n'a pas de débordement horizontal.

Liens connexes

  • [[everjust-website-customization]] — service via pièces jointes Odoo + intégration dans la vue.
  • [[cdp-render-verification]] — la preuve de lecture.
  • [[remotion]] / [[moviepy]] — création/animation de vidéo (le travail inverse).

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ever-just/agentskills

> Declarative animations for React. Springs, gestures, layout animations, and page transitions. GPU-accelerated, production-ready.

ever-just/agentskills

> Create animated logos, icons, and micro-interactions as lightweight Lottie JSON files. No After Effects needed — build animations entirely in code.

ever-just/agentskills

> A TypeScript library using generators to program animations with a real-time editor. Ideal for explainer videos, code walkthroughs, and educational content.

ever-just/agentskills

> Add animated subtitles and captions to Remotion videos from .SRT files. TikTok-style word-by-word highlights, karaoke effects, and more.

ever-just/agentskills

> Create videos programmatically using React components. The most mature framework for code-driven video production.

ever-just/agentskills

> Copy-paste video components for Remotion. Intros, text effects, transitions, and full scene templates. Like shadcn/ui but for video.

ever-just/agentskills

Extract actionable intelligence from video content across YouTube, Vimeo, and company websites. Video reveals what text sources cannot: facility scale, team composition, product demonstrations, signage, event attendance, and operational reality.

ever-just/agentskills

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

ever-just/agentskills

Automatically fetch YouTube video transcripts, generate structured summaries, and send full transcripts to messaging platforms. Detects YouTube URLs and provides metadata, key insights, and downloadable transcripts.

Skills associés