Communitygithub.com

ever-just/agentskills

Otimize e incorpore um vídeo existente como um hero/background/loop rápido, nítido e com reprodução automática em um site. Use ao adicionar ou substituir um vídeo em um site de marketing que está muito pesado, não reproduz automaticamente (especialmente em dispositivos móveis/Safari), apresenta erro de codec ou parece desfocado — para transcodificá-lo para H.264 compatível com a web, com o formato de pixel correto, faststart, dimensionamento consciente de retina e um frame de poster, e então incorporá-lo e verificar se ele realmente reproduz. Isso é otimização + incorporação de material que você já possui, não criação/animação de vídeo (para isso, use remotion/moviepy/motion-canvas). Use quando o usuário disser

O que é agentskills?

Este skill automatiza a otimização e incorporação de vídeos existentes para uso como hero, background ou loop em sites de marketing. Ele resolve problemas comuns como vídeos pesados, falha na reprodução automática (especialmente em dispositivos móveis e Safari), erros de codec e baixa nitidez. O fluxo principal envolve inspecionar o vídeo com ffprobe, transcodificá-lo para H.264 com configurações otimizadas (pixel format yuv420p, faststart, escala retina-aware para 2x a largura CSS, taxa de quadros de 30 fps), gerar um frame de poster representativo e incorporar o vídeo com as tags HTML corretas (autoplay, muted, loop, playsinline, preload). O skill também fornece instruções para servir o vídeo em tenants Odoo e enfatiza a verificação obrigatória da reprodução usando ferramentas de automação de navegador. É direcionado para desenvolvedores web que precisam substituir ou adicionar vídeos otimizados em sites existentes, com foco em performance, compatibilidade cross-browser e qualidade visual em telas retina.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Documentação

Otimização de Vídeo para Incorporação Web

Transforme um clipe de origem (gravação de tela, exportação de celular, renderização HEVC) em um hero/background/loop rápido, nítido e com reprodução automática confiável e incorpore-o. A vantagem geralmente é grande: H.264 consciente de retina com um CRF razoável reduz uma gravação de tela 1080p de ~8 MB para ~1.5 MB sem perda visível e corrige problemas de reprodução automática/codec.

Para criar ou animar vídeo, use [[remotion]] / [[moviepy]] / [[motion-canvas]] — este skill otimiza material que você já possui.

Quando usar

  • Adicionar/substituir um vídeo hero, de fundo ou de demonstração em loop em um site.
  • O vídeo está muito pesado, não reproduz automaticamente (dispositivos móveis/Safari), apresenta erro de codec ou parece desfocado.

Receita

1. Inspecione primeiro

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   # áudio?
# verificação faststart: 'moov' está antes de 'mdat'? (moov no final = início lento)

2. Transcodifique (seguro para web + consciente de retina)

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 — obrigatório para Safari/suporte amplo (yuv444/422 não reproduzem).
  • -movflags +faststart — move o átomo moov para o início para que o vídeo comece antes do download completo. Sem ele, um hero com reprodução automática trava em conexões lentas.
  • -an — remove áudio; um loop de fundo sem áudio nunca precisa (arquivo menor).
  • scale=1600:-2 — codifica para aproximadamente 2× a largura de exibição CSS, não 1080p/4K nativo. Em um quadro ≤820px, 1600px é nítido em retina e muito mais leve. -2 mantém a altura par (exigido pelo H.264).
  • -crf 23 -preset slow — alta qualidade, boa compressão. Conteúdo de tela/UI comprime especialmente bem; aumente o CRF para 25–26 somente se o arquivo ainda estiver pesado.

3. Frame de poster

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

Escolha um momento representativo (-ss), não um frame de introdução em branco.

4. Incorpore

<video autoplay muted loop playsinline preload="auto" poster="/caminho/poster.jpg">
  <source src="/caminho/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay são todos necessários para reprodução automática em dispositivos móveis.
  • CSS do contêiner: video{display:block;width:100%;height:auto} permite que um clipe 16:9 defina sua própria altura; envolva em um quadro com overflow:hidden;border-radius.

5. Sirva (tenants Odoo)

Armazene como um ** ir.attachment público** e referencie /web/content/<id> (vídeo) e /web/image/<id> (poster) — veja [[everjust-website-customization]]. Transfira o binário via docker cp (o shell é executado dentro do contêiner). Use IDs de anexo novos e redirecione a view, em vez de sobrescrever IDs antigos, para evitar cache obsoleto do navegador/CDN. Edições de view exigem reinicialização do contêiner para renderizar.

Verifique (obrigatório)

Confirme se ele realmente reproduz com [[cdp-render-verification]] — inicie o Chrome com --autoplay-policy=no-user-gesture-required, então leia o elemento <video>:

  • readyState === 4 (HAVE_ENOUGH_DATA), paused === false, currentTime > 0 após uma curta espera (avançando) e videoWidth/videoHeight correspondem à codificação.
  • Verifique desktop e dispositivos móveis e se a página não possui overflow horizontal.

Relacionados

  • [[everjust-website-customization]] — serviço via anexos Odoo + incorporação em view.
  • [[cdp-render-verification]] — a prova de reprodução.
  • [[remotion]] / [[moviepy]] — criação/animação de vídeo (o trabalho oposto).

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.

Habilidades Relacionadas