Communitygithub.com

ever-just/agentskills

既存の動画を最適化し、高速で鮮明な自動再生ヒーロー/背景/ループ動画としてWebサイトに埋め込みます。動画が重すぎる、自動再生できない(特にモバイル/Safari)、コーデックエラーが表示される、またはぼやけて見える場合に使用します。

agentskills とは?

このスキルは、既存の動画ファイル(スクリーンキャプチャ、スマートフォン書き出し、HEVCレンダリングなど)を、Webサイトのヒーロー動画や背景ループ動画として埋め込むための最適化を実施します。具体的な処理工程には、ffprobeによる動画プロパティの調査、ffmpegを用いたWebセーフなH.264形式へのトランスコード、ポスターフレームの生成、HTMLへの埋め込みコードの提供、そしてCDPレンダリング検証による実際の再生確認が含まれます。主な最適化ポイントは、Safariでも再生可能なyuv420pピクセルフォーマット、自動再生を確実にするfaststartムービーフラグ、表示サイズに応じた網膜ディスプレイ対応のスケーリング(例:1600px幅)、CRF 23を使用した品質とファイルサイズのバランス、およびオーディオストリームの除去です。ファイルサイズは、例えば1080pのスクリーンキャプチャで約8MBから1.5MBに削減でき、視覚的な劣化はほとんどありません。Odooテナントの場合は、公開ir.attachmentとして保存し、ビューから参照する方法も示しています。このスキルは既存の動画素材を最適化することに特化しており、新規動画の作成やアニメーションには対応していないため、そのような用途ではremotionやmoviepyを使用してください。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

ドキュメント

Web埋め込み動画最適化

ソースクリップ(画面収録、スマートフォン書き出し、HEVCレンダリング)を、高速で鮮明、確実に自動再生される ヒーロー/背景/ループ動画に変換し、埋め込みます。効果は通常大きく、網膜ディスプレイ対応のH.264を適切なCRFでエンコードすることで、1080pの画面収録が約8MBから目に見える劣化なく約1.5MBになり、自動再生やコーデックの問題も解決します。

動画の作成やアニメーションには、代わりに [[remotion]] / [[moviepy]] / [[motion-canvas]] を使用してください。このスキルは既存の映像素材を最適化します。

使用するタイミング

  • サイトのヒーロー、背景、またはループするデモ動画を追加/置き換える場合。
  • 動画が重すぎる、自動再生できない(モバイル/Safari)、コーデックでエラーが発生する、またはぼやけて見える場合。

レシピ

1. まずプローブ

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   # 音声?
# faststartの確認: 'moov' が 'mdat' より前にあるか? (moovが末尾にあると起動が遅い)

2. トランスコード(Webセーフ + 網膜ディスプレイ対応)

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 — Safari/広範なサポートに必須(yuv444/422は再生不可)。
  • -movflags +faststart — moovアトムを先頭に移動し、完全にダウンロードされる前に再生を開始できるようにします。これがないと、自動再生ヒーローが遅いリンクで停止します。
  • -an — オーディオを除去。ミュートされた背景ループでは不要です(ファイルサイズが小さくなります)。
  • scale=1600:-2 — ネイティブの1080p/4Kではなく、CSS表示幅の約2倍にエンコードします。フレームが≤820pxの場合、1600pxで網膜ディスプレイに鮮明であり、はるかに軽量です。-2 は高さを偶数に保ちます(H.264で必要)。
  • -crf 23 -preset slow — 高品質、良好な圧縮。画面/UIコンテンツは特に圧縮効率が良いです。それでもファイルが重い場合のみ、CRFを25~26に上げてください。

3. ポスターフレーム

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

空白のイントロフレームではなく、代表的な瞬間(-ss)を選びます。

4. 埋め込み

<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
  <source src="/path/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay はモバイルでの自動再生にすべて必須です。
  • コンテナCSS: video{display:block;width:100%;height:auto} とすると、16:9のクリップが自身の高さを設定できます。枠で囲み、overflow:hidden;border-radius を設定します。

5. 配信(Odooテナント)

公開 ir.attachment として保存し、/web/content/<id>(動画)と /web/image/<id>(ポスター)で参照します — [[everjust-website-customization]] を参照してください。バイナリは docker cp で転送します(シェルはコンテナ内で実行)。新しい添付ファイルID を使用してビューを再ポイントし、古いIDを上書きしないようにして、ブラウザ/CDNキャッシュの問題を回避します。ビューの編集後は、レンダリングのためにコンテナの再起動が必要です。

確認(必須)

実際に再生されることを、[[cdp-render-verification]] を使用して確認します — Chromeを --autoplay-policy=no-user-gesture-required で起動し、<video> 要素を読み取ります:

  • readyState === 4 (HAVE_ENOUGH_DATA)、paused === false、短い待機後に currentTime > 0(進行中)、videoWidth/videoHeight がエンコードと一致すること。
  • デスクトップとモバイルの両方で確認し、ページに水平方向のオーバーフローがないことを確認します。

関連

  • [[everjust-website-customization]] — Odoo添付ファイル+ビュー埋め込みによる配信。
  • [[cdp-render-verification]] — 再生の証明。
  • [[remotion]] / [[moviepy]] — 動画の作成/アニメーション(逆の作業)。

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.

関連スキル