Communitygithub.com

ever-just/agentskills

Optimiza e incrusta un video existente como un hero/background/loop de carga rápida y nítida para sitios web. Se usa al agregar o reemplazar un video en un sitio de marketing si es demasiado pesado, no se reproduce automáticamente (especialmente en móvil/Safari), muestra error de codec o se ve borroso, transcodificándolo a H.264 seguro para web con el formato de píxel correcto, faststart, escalado retina-aware y un fotograma de póster, luego lo incrusta y verifica que realmente se reproduzca. Esto es optimización e incrustación de material que ya tienes, no creación/animación de video (para eso usa remotion/moviepy/motion-canvas). Úsalo cuando el usuario diga «agrega este video al sitio», «el video hero es demasiado grande / no se reproduce / no es nítido», «reemplaza el video de la página de inicio» o «haz que este video se repita en la página de aterrizaje».

¿Qué es agentskills?

Este skill optimiza videos existentes para la web, transformando clips de pantalla, exportaciones de teléfono o renders HEVC en videos hero/background/loop que se reproducen de forma rápida, nítida y automática. Es especialmente útil cuando un video es demasiado pesado, no se reproduce en móviles o Safari, muestra errores de codec o se ve borroso. Está diseñado para desarrolladores que trabajan con sitios de marketing y necesitan integrar videos de alto rendimiento. El skill usa FFmpeg para transcode a H.264 con formato de píxel yuv420p (obligatorio para Safari), faststart para inicio rápido, escalado retina-aware (por ejemplo, 1600px para un marco de 820px) y elimina el audio para reducir el tamaño. Luego genera un fotograma de póster y proporciona el HTML de incrustación con los atributos necesarios (autoplay, muted, loop, playsinline) para garantizar la reproducción automática en móviles. También incluye verificación mediante CDP para confirmar que el video se reproduce correctamente. Es compatible con proyectos web que usan Odoo, pero los principios son aplicables a cualquier sitio. No reemplaza herramientas de creación de video como Remotion, MoviePy o Motion Canvas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Documentación

Optimización de video para incrustación web

Convierte un clip fuente (grabación de pantalla, exportación de teléfono, render HEVC) en un hero/background/loop de carga rápida, nítido y con reproducción automática confiable y lo incrusta. La mejora suele ser grande: H.264 retina-aware con un CRF sensato reduce una grabación de pantalla 1080p de ~8 MB a ~1.5 MB sin pérdida visible, y soluciona problemas de reproducción automática/códec.

Para crear o animar video, usa [[remotion]] / [[moviepy]] / [[motion-canvas]] en su lugar — este skill optimiza material que ya tienes.

Cuándo usarlo

  • Al agregar o reemplazar un video hero, de fondo o de demostración en bucle en un sitio.
  • El video es demasiado pesado, no se reproduce automáticamente (móvil/Safari), da error de códec o se ve borroso.

Receta

1. Analizar primero

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?
# verificación de faststart: ¿'moov' está antes que 'mdat'? (moov al final = inicio lento)

2. Transcodificar (seguro para web + retina-aware)

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 — obligatorio para Safari/soporte amplio (yuv444/422 no se reproduce).
  • -movflags +faststart — mueve el átomo moov al frente para que comience antes de descargarse por completo. Sin esto, un hero con reproducción automática se detiene en conexiones lentas.
  • -an — elimina audio; un fondo en bucle silenciado nunca lo necesita (archivo más pequeño).
  • scale=1600:-2 — codifica aproximadamente a 2× el ancho de visualización CSS, no a 1080p/4K nativos. Con un marco ≤820px, 1600px es retina-crisp y mucho más ligero. -2 mantiene la altura par (requerido por H.264).
  • -crf 23 -preset slow — alta calidad, buena compresión. El contenido de pantalla/UI se comprime especialmente bien; sube CRF a 25–26 solo si el archivo sigue siendo pesado.

3. Fotograma de póster

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

Elige un momento representativo (-ss), no un fotograma de introducción en blanco.

4. Incrustar

<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
  <source src="/path/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay son todos necesarios para la reproducción automática en móvil.
  • CSS del contenedor: video{display:block;width:100%;height:auto} permite que un clip 16:9 establezca su propia altura; envuélvelo en un marco con overflow:hidden;border-radius.

5. Servir (inquilinos Odoo)

Almacena como un ir.attachment público y referencia /web/content/<id> (video) y /web/image/<id> (póster) — consulta [[everjust-website-customization]]. Transfiere el binario mediante docker cp (el shell se ejecuta dentro del contenedor). Usa IDs de adjunto nuevos y reasigna la vista, en lugar de sobrescribir IDs antiguos, para evitar caché obsoleto del navegador/CDN. Los cambios de vista necesitan un reinicio del contenedor para renderizarse.

Verificar (obligatorio)

Confirma que realmente se reproduce con [[cdp-render-verification]] — lanza Chrome con --autoplay-policy=no-user-gesture-required, luego lee el elemento <video>:

  • readyState === 4 (HAVE_ENOUGH_DATA), paused === false, currentTime > 0 después de una espera breve (avanzando), y videoWidth/videoHeight coinciden con la codificación.
  • Verifica en escritorio y móvil, y que la página no tenga desbordamiento horizontal.

Relacionados

  • [[everjust-website-customization]] — servir mediante adjuntos Odoo + incrustación en vista.
  • [[cdp-render-verification]] — la prueba de reproducción.
  • [[remotion]] / [[moviepy]] — crear/animar video (la tarea opuesta).

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 relacionados