Communitygithub.com

Web-Einbettung Videoptimierung

Optimieren und einbetten eines vorhandenen Videos als schnelle, scharfe, automatisch abspielende Hero-/Hintergrund-/Loop-Darstellung auf einer Website.

Was ist Web-Einbettung Videoptimierung?

Dieses Skill optimiert und bettet vorhandene Videoclips (Bildschirmaufnahmen, Telefonaufnahmen, HEVC-Renderings) als leichte, automatisch abspielbare und scharfe Hero-, Hintergrund- oder Loop-Videos auf Websites ein. Es behebt typische Probleme wie große Dateigrößen, fehlende Wiedergabe auf mobilen Geräten und im Safari-Browser, Codec-Fehler oder unscharfe Darstellung. Der Optimierungsprozess verwendet ffprobe und ffmpeg, um das Video in ein web-sicheres H.264-Format mit dem richtigen Pixelformat (yuv420p), faststart (moov vor mdat), retina-bewusster Skalierung (z. B. 1600px Breite), verlustfreier oder hochwertiger Kompression (CRF 23) und ohne Audio (für Hintergrundschleifen) zu transkodieren. Anschließend wird ein Poster-Frame extrahiert und das Video mit den HTML-Attributen `autoplay`, `muted`, `loops` und `playsinline` eingebettet, die für die automatische Wiedergabe auf mobilen Geräten erforderlich sind. Die Überprüfung der tatsächlichen Wiedergabe erfolgt via CDP (Chrome DevTools Protocol), um sicherzustellen, dass `readyState` = 4, `paused` = false und `currentTime` > 0 ist. Dieses Skill ist für die Optimierung vorhandenen Videomaterials gedacht; für die Erstellung oder Animation von Videos sind andere Tools wie Remotion, MoviePy oder Motion Canvas vorgesehen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

Dokumentation

Optimierung von Web-Video Einbettungen

Wandeln Sie einen Quellclip (Bildschirmaufnahme, Telefon-Export, HEVC-Rendering) in ein schnelles, scharfes, zuverlässig automatisch abspielendes Hero-/Hintergrund-/Loop-Video um und betten Sie es ein. Der Gewinn ist in der Regel groß: Ein retina-bewusstes H.264 mit einer angemessenen CRF reduziert eine 1080p-Bildschirmaufnahme von ~8 MB auf ~1,5 MB ohne sichtbaren Qualitätsverlust und behebt Autoplay-/Codec-Probleme.

Für das Erstellen oder Animieren von Videos verwenden Sie stattdessen [[remotion]] / [[moviepy]] / [[motion-canvas]] – dieses Skill optimiert bereits vorhandenes Filmmaterial.

Wann verwenden

  • Hinzufügen/Ersetzen eines Hero-, Hintergrund- oder Schleifendemo-Videos auf einer Website.
  • Das Video ist zu schwer, startet nicht automatisch (mobil/Safari), zeigt einen Codec-Fehler oder wirkt unscharf.

Rezept

1. Zuerst analysieren

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?
# faststart-Prüfung: Ist 'moov' vor 'mdat'? (moov am Ende = langsamer Start)

2. Transkodieren (websicher + retina-bewusst)

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 – zwingend erforderlich für Safari/breite Unterstützung (yuv444/422 werden nicht abgespielt).
  • -movflags +faststart – verschiebt das moov-Atom an den Anfang, sodass die Wiedergabe beginnt, bevor der gesamte Download abgeschlossen ist. Ohne diesen Parameter bleibt ein automatisch abspielendes Hero bei langsamen Verbindungen stecken.
  • -an – Audio entfernen; eine stummgeschaltete Hintergrundschleife benötigt es nie (kleinere Datei).
  • scale=1600:-2 – Kodierung auf etwa 2× die CSS-Anzeigebreite, nicht native 1080p/4K. Bei einem Rahmen von ≤820px sind 1600px retina-scharf und viel leichter. -2 behält eine gerade Höhe bei (von H.264 gefordert).
  • -crf 23 -preset slow – hohe Qualität, gute Kompression. Bildschirm-/UI-Inhalte komprimieren besonders gut; erhöhen Sie CRF auf 25–26 nur, wenn die Datei immer noch zu groß ist.

3. Poster-Frame

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

Wählen Sie einen repräsentativen Zeitpunkt (-ss), keinen leeren Intro-Frame.

4. Einbetten

<video autoplay muted loop playsinline preload="auto" poster="/pfad/poster.jpg">
  <source src="/pfad/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay sind alle für die automatische Wiedergabe auf mobilen Geräten erforderlich.
  • Container-CSS: video{display:block;width:100%;height:auto} erlaubt einem 16:9-Clip, seine eigene Höhe zu setzen; wickeln Sie ihn in einen Rahmen mit overflow:hidden;border-radius ein.

5. Ausliefern (Odoo-Mandanten)

Speichern Sie als öffentliches ir.attachment und referenzieren Sie /web/content/<id> (Video) und /web/image/<id> (Poster) – siehe [[everjust-website-customization]]. Übertragen Sie die Binärdatei mittels docker cp (die Shell läuft innerhalb des Containers). Verwenden Sie frische Attachment-IDs und passen Sie die Ansicht an, anstatt alte IDs zu überschreiben, um veralteten Browser-/CDN-Cache zu vermeiden. Ansichtsänderungen erfordern einen Container-Neustart, um gerendert zu werden.

Überprüfen (obligatorisch)

Bestätigen Sie, dass es tatsächlich abgespielt wird, mit [[cdp-render-verification]] – starten Sie Chrome mit --autoplay-policy=no-user-gesture-required, lesen Sie dann das <video>-Element aus:

  • readyState === 4 (HAVE_ENOUGH_DATA), paused === false, currentTime > 0 nach kurzer Wartezeit (fortschreitend) und videoWidth/videoHeight entsprechen der Kodierung.
  • Überprüfen Sie Desktop und Mobilgerät und dass die Seite keinen horizontalen Überlauf aufweist.

Verwandte Skills

  • [[everjust-website-customization]] – Auslieferung über Odoo-Attachments + Ansichtseinbettung.
  • [[cdp-render-verification]] – der Abspielnachweis.
  • [[remotion]] / [[moviepy]] – Videos erstellen/animieren (die gegenteilige Aufgabe).

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.

Verwandte Skills