Communitygithub.com

html-motion-pipeline

パイプラインHTML→MP4:9:16のナレーション付き説明ビデオ(Reels/TikTokの教育系アカウントのような2Dフラットモーションスタイル)—「Function Callingとは?」(44.6秒、1080×1920、VO+31 SFX同期)を実際に生成した実績。ユーザーが自分で用意したVOを使用した9:16モーショングラフィック説明ビデオ、単語単位の字幕、ノード↔ツールのアニメーション、最終MP4出力をリクエストした場合に使用。音声はユーザーのVOファイル(TTSではなく)、必要に応じて ffmpeg atempo で速度調整。

html-motion-pipeline とは?

このスキルは、HTMLとモダンなフロントエンド技術(GSAPアニメーション、Playwrightによるヘッドレスレンダリング)を活用して、高品質な9:16モーショングラフィック説明動画を生成するパイプラインを提供します。主にReelsやTikTok向けの教育系コンテンツを想定しており、ユーザー自身の声(ElevenLabsなどで収録したVOファイル)を使用し、各単語のタイムスタンプに合わせた字幕アニメーションや、ノード間の接続線、タイピングアニメーションなどを実現します。パイプラインは決定論的で、各フレームをシークしてキャプチャするため、MP4出力は開発中のプレビューと完全に一致します。重要なのは、レイアウト監査(テキストのはみ出し、重なり、垂直方向の偏りを検出)を必ず通過させてからフルレンダリングを行うことで、無駄なレンダリングを防ぎます。また、コードエディタで動作するため、Cursor、Claude Code、Codexなど、ファイル作成・編集・コマンド実行が可能なAIエージェントプラットフォームで使用できます。このスキルは、視覚がナレーションとスクリプトに従うという原則(表示されるすべての要素はスクリプトに存在し、VOで語られている必要がある)に厳密に従い、豊富なアニメーションとビジュアルで動画をより生き生きとさせます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hasbiridwan57-creator/hermes-video-motion-skills/tree/main/html-motion-pipeline

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

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

ドキュメント

HTML Motion Pipeline(9:16 説明動画、VO + SFX → MP4)

実績のあるワークフローです。各ステップには assets/pipeline/ にすぐ使えるコマンドが用意されています。 完全な実装例は assets/pipeline/index.fc-reference.html(Function Calling プロジェクト)を参照 — コピーして内容を置き換えてください。ゼロから書き始める必要はありません。

なぜこのパイプラインか

  • 決定論的: GSAP タイムラインは paused 状態で、フレームごとにシーク → MP4 はプレビューと完全一致。
  • ユーザー自身のVO(ElevenLabs / マイクで録音したファイル。TTSではありません); テンポは制御可能。
  • 自動レイアウト監査が、テキストのキャンバス外への飛び出しや要素同士の重なりを検出 — フルレンダリング前に必ず通過させる必要があります(1338フレームのレンダリングを節約)。
  • きれいな接続線: ノードの端にアンカーを設定し、背面レイヤーに配置します( Pitfall #1 参照)。

主要原則(これが核です)

映像はスクリプトとVOに奉仕し、その逆ではありません。

  1. 画面に表示されるすべての要素は、スクリプトに存在し、VOで発話されている必要があります。面白くてもナレーションされていない要素は、どんなに優れていても削除すること。
  2. 逆に、スクリプト内の重要なアイデアや文はそれぞれ固有のビジュアルを持ち、そのフレーズが発話されている間に表示されなければなりません。単なる静止テキストになっている文は「静かな」シーンです → ビジュアルを追加してください。
  3. シーンの数が多くなっても問題ありません — 重要なのは各シーンがVOとスクリプトに従っていることです。
  4. より多くの画像とアニメーション = より良い結果(より生き生きとします)。ビジュアルを追加することを躊躇しないでください。豊かなビジュアルは付加価値であり、弱点ではありません。
  5. ビジュアルの順序とタイミングは、VOでの言及の順序とタイミング(文字起こしのタイムスタンプから)に従うものであり、独自の論理に従うものではありません。
  6. ビジュアルの詳細の品質も維持されます:アイコンは何を意味するか明確に読み取れ、要素はバランスが取れており、浮遊感がありません。

ワークフロー(順序に従ってください)

#ステップ出力
1ユーザーのVOを取得し、セグメント(呼吸の間隔)で分割meta.json
2ffmpeg atempo でVOのテンポを調整 + 間を挿入。バリアントを選択vo.wav
3単語単位の文字起こし(faster-whisper、pip install faster-whisper)assets/words.json
4index.html を構築(VOのタイミングに合わせた8シーン)+ sfx_score.pyHTML + SFX WAV
5VOとSFXをミックス → public/full_mix.mp3最終オーディオ
6レイアウト監査(audit2.mjs + audit_s2.mjs)— オーバーフロー0は必須レポート
7フレームレンダリング(render_frames.mjs)→ 1338 PNGframes/
8エンコード(encode.sh)→ MP4public/*.mp4
9最終MP4のビジュアルチェック — MP4からフレームを抽出し、Vision APIで分析クリーン確認

1度だけのセットアップ

cd <プロジェクト>
npm init -y && npm install playwright-core gsap
pip install faster-whisper   # 単語ごとの文字起こし用
# 必要なもの: Google Chrome(/Applications/Google Chrome.app)、ffmpeg

パイプラインスクリプト

assets/pipeline/:

  • render_frames.mjs — タイムラインをフレームごとにシークし、1080×1920 @30fps でスクリーンショットを撮ります。
  • snap.mjs — 特定の秒数のスナップショットを撮影します(node snap.mjs 1.0 6.5 17.5)。ビジュアル確認用。
  • audit2.mjs — すべてのシーンをチェック:テキストのキャンバス外への飛び出し / 下部UIゾーン(>1560px)への侵入 / 衝突。
  • audit_s2.mjs — 1つのシーン(sc2)を複数の秒数で監査(早すぎるリビール、端への接近を検出)。
  • audit_overlap.mjs — 実際に重なっているテキストを検出(テキスト×テキスト、テキスト×画像、テキスト×ボタン)。意図的な重なり(SVGコンテナ内のラベル、取り消し線/線、横並びのフレックス字幕など)は賢く区別し、報告しません。 実行方法:node assets/pipeline/audit_overlap.mjs → 目標は TOTAL 重なり: 0。
  • audit_center.mjs — 「上部に浮いている」コンテンツを検出(下部3分の2が空)。各シーンのコンテンツのバウンディングボックスを測定し、理想的な中央点(1920px では y≈960)からの偏差を計算。偏差 > 250px は ⚠ 浮き。実行方法:node assets/pipeline/audit_center.mjs。
  • typing-prompt.js — 「タイピングプロンプト」アニメーションのレシピ(コーディング/AIテーマの核心):プロンプトが一字ずつタイプされ、カーソルが点滅し、アプリが応答(色変更 → エラー → 修正 → 反復)。完全な例:09-vibe-coding/index.html の SK4 シーン。
  • encode.sh — ffmpeg → H.264 yuv420p CRF18 + AAC 192k + +faststart。
  • sfx_score.py — 手続き型SFXスコア、単語のタイミングに同期。
  • index.fc-reference.html — 完全な実装(コピー&コンテンツ置き換え用)。

HTML の規則(index.fc-reference.html内)

  • #stage は 1080×1920、ドットグリッド背景。#world(カメラリグ、シーンごとに微妙なスケール)。シーン = .scene(visibility hidden、タイムラインで表示/非表示を切り替え)。
  • 単語ごとの字幕: assets/words.json → 最大4単語のチャンクにグループ化、1チャンク = 1 .line(position:absolute、積み重ねてボックスを広げないようにする)。アクティブな単語は .on、キーワードは .key(琥珀色)。下部から390pxの位置(Reels/TikTokのUIが下部約360pxを覆うため、それを避ける)。
  • 接続線: link(svg,idA,idB) 関数はノードの端(edge/edgeT)のアンカーを計算 — 線はロゴの中心から出ません。SVG .wires は .scene の最初の子要素として配置され(z-index:0)、カード(z-index:2)の背面になります。滑らかな曲線(bow ≤26px)、色はグレー #7A8188 8px。アクティブな線は .hot で琥珀色15px。
  • エージェントロゴ: OPENCLAW_SVG インライン(赤いロブスター)、🤖 を含む各 .node.dark に自動的に配置。別のアイデンティティが必要な場合は変更可能。
  • GSAP 決定論的:タイムラインは paused 状態で、window.__tl と window.__updateSub を公開。?t=<秒> モードで静的スナップショット(ヘッドレス)、?debug で手動スクラブ。

トリガー

ユーザーが 「pipeline motion explainer」 というフレーズ、または「9:16 のモーション説明動画」をリクエストした場合、あるいは「以前の Function Calling 動画のように」と言った場合 → このスキルをロードします。motion-format / bang-motion(別のスキル)ではありません。ユーザーのVOは毎回ファイルとして送信されます — このスキルは動作方法を保存するもので、オーディオ/コンテンツのアセットを保存するものではありません。

注意点(繰り返さないでください)

  1. 線がロゴ/テキストを貫通する → 確認事項:(a) SVG ワイヤーがシーンの最初の子要素であること、(b) ワイヤーの z-index:0 に対してカードの z-index:2、(c) アンカーに link() を使用して端に配置すること。
  2. 字幕がカードを覆う / UIゾーンに入る → 1行1スタック(absolute)、最大4単語/チャンク、下部 ≥390px。
  3. レンダリング時の window.tl 未定義 → 公開する名前は window.__tl (__ を使用)でなければなりません。そうしないと、74% のフレームが同一/静的になります。確認:md5 frames/* | uniq -c。
  4. レンダリングのバックグラウンド再起動 → 新しいレンダリングの前に古い render_frames が実行されていないことを確認(pgrep -fl render_frames)。開始前に frames/ を削除します。
  5. DOM監査は最終MP4のビジュアルチェックの代わりにはなりません。 監査はオーバーフローとバウンディングボックスの衝突を検出しますが、線がロゴを貫通する / テキストがカードを覆う ことは検出しません — それらは最終ピクセルでのみ確認できます。エンコード後、MP4からキーフレームを抽出し(ffmpeg -ss <t> -i out.mp4 -frames:v 1 f.png)、vision_analyze で分析します。
  6. 「上部に浮いている」コンテンツ(下部3分の2が空)。 これは、通常の監査がオーバーフローだけをチェックし、バランスをチェックしないため、最も頻繁にすり抜けます。原因:すべての .hero の子要素が position:absolute を使用しているため、flexbox の justify-content:center がそれらに効果を持ちません。解決策:.hero の子要素を通常のフロー(block/flex フロー)にし、重なる要素(バッジ/取り消し線/マーカー)だけを absolute のままにします。audit_center.mjs を必ず実行 — 中心偏差 > 250px = 失敗。
  7. ビジュアルがスクリプトに従っていない(最も有害)。 アニメーションが動いているからといって、シーンが「完成」したと思わないでください。実際の例:相関グラフと年齢グラフが画面に表示されているのに、VOがそれらに言及していない。レンダリング前のスクリプト監査必須:(a) 文字起こしVO + 単語ごとのタイムスタンプ(words.json)を抽出、(b) 「このフレーズは画面で何時に表示されるか?」をマッピング、(c) スクリプトにないが表示されている要素 → 削除。スクリプト内のフレーズで、静止テキストになっているもの → ビジュアルを追加。ビジュアルの順序 = VOでの言及順序。
  8. レンダリング時のメモリ不足(Mac 8GB)。 Chromiumは数百枚のスクリーンショットを出力する際にメモリを蓄積し、途中でクラッシュします(「Target page closed」)。解決策:約400フレームごとにブラウザを再起動 + 自動再開(既存の >20KB のフレームはスキップ)。1回のブラウザセッションで2500フレーム以上をレンダリングしないでください。
  9. リビジョン後に古いフレームが混ざる。 一部のシーンのみをリビジョンし、その範囲のフレームだけを削除した場合、frames/ が混在します(例:必要なフレームが2574なのに2770ファイルある)。最も安全な方法:フルレンダリングの前に frames/ 全体を削除します。再開する場合は、ファイル数がエンコード前の総フレーム数と一致することを確認します。
  10. 絵文字がDOM監査をすり抜ける。 ユーザーが絵文字なしを要求した場合 — 自動チェックしなければ、バウンディングボックス監査が文字の種類を見ないため、絵文字がすり抜ける可能性があります。レンダリング前に、Python の正規表現で絵文字を検索。見つかった場合はインラインSVGに置き換えます。アイコンは常にSVGにします。 re.findall(r'[\U0001F300-\U0001FAFF\u2600-\u27BF\u2B00-\u2BFF\uFE0F]', html) → 必ず0に。
  11. アイコンとビジュアル詳細は表示サイズで読み取れる必要があります — DOM監査とレイアウト監査は「アイコンが不明瞭」を捉えません。 SVG はコード上では正しい形状でも、レンダリングサイズ(例:図中の180pxアイコン)では別のものに見えることがあります:輪郭が開いた脳のアイコンは、脳ではなく雲/花に見えます。修正方法: フルレンダリング前に、MP4からフレームを抽出し、キーとなるアイコン/図を拡大(クロップ)して vision_analyze で評価 — 「これは X として明確に読み取れますか?」。曖昧な場合は、形状を簡略化し(開いた輪郭よりも塗りつぶしのシルエット)、サイズを大きくします。バウンディングボックス監査は位置のみをチェックし、形状の読み取りやすさはチェックしません。
  12. 比較要素(A対Bの棒/列)は必ず1つのビジュアルグループにします。 親カードの外に「浮いている」棒(別々の絶対位置)は、バランスを崩し、コンテンツの高さが変わったときに他の要素を覆いやすくなります。実際の例:筋萎縮/強い筋肉の棒がジムカードの外に浮き、別のカードに衝突しました。修正方法: 各棒を自身のカード/列セルの中に入れます。棒の長さの違いは意図的(長さ = 値)ですが、カードの幅とベースラインは統一します。レイアウトを変更するたびに audit_overlap で確認します。
  13. テキストが「ほんの少し」重なっているように見えても重なり。 目に頼らないでください。実際のバウンディングボックスを測定する audit_overlap.mjs を使用します。巨大な ?、装飾的な大きな数字、長いタイトルは、気づかないうちに他のテキストを覆っていることがよくあります。
  14. コーディング/AIテーマは、タイピングアニメーションなしでは死んでいるように感じられます。 静的テキストは、バイブコーディングの動作方法を伝えません。typing-prompt.js のレシピを使用:プロンプトが一字ずつタイプされ、カーソルが点滅し、アプリが応答(色変更 → エラー → 修正 → 反復)。
  15. Webからのロゴ/アイコン:公式のSVG(jsDelivr CDN / GitHub ブランドリポジトリ)をダウンロードし、HTMLにインラインでテキストとして埋め込みます — 外部ファイルへの <img src> は使用しないでください。ヘッドレスレンダリングがネットワークに依存しないようにするためです。出力を決定論的にするために、SMILアニメーションは削除します。

音声ルール(ユーザー Hasbi)

  • VO制作はユーザー自身の声(送信されたElevenLabsファイル)である必要があります。TTSではありません。
  • 手続き型SFXは procedural-sfx スキルを介して(ElevenLabsのクレジットは使用しません)。
  • MP4送信後、生フレームと補助ファイル(frames/、shots/、セグメントごとの *.wav)は削除 — MacBookのストレージは限られています。

Individual skills in this repo

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

motion-format

Bikin video motion graphic lewat chat dengan alur kerja Motion Format — Reels/TikTok/Shorts 9:16, YouTube 16:9, atau feed 1:1 — dari brief sampai MP4 bersuara (voiceover + efek suara ElevenLabs, subtitle per kata). Punya resep gaya siap pakai dari seri konten Motion Format: Isometrik Dibongkar (cara kerja mesin, 3D), Sejarah 3D Sinematik (bangunan & peristiwa bersejarah), Tubuh Manusia Anime (organ tubuh), Dunia 2D Bertekstur (noir, cat air, ukiran, lanskap anime), Kartun Cel Cerah (tokoh menjelaskan), Peta Relief Sinematik (geografi, jalur, wilayah), dan Promo Produk & Iklan (UMKM, aplikasi, flash sale) — plus cara meracik gaya sendiri. Gunakan setiap kali user meminta "video", "konten Reels/TikTok/Shorts", "explainer", "video edukasi", "video penjelasan", "promo", "iklan", "intro", "animasi", "motion graphic", menyebut salah satu gaya di atas atau "Resep Gaya", ingin menambah voiceover/efek suara/subtitle, ingin merevisi video yang sudah ada, atau ingin merender jadi MP4 — walau tida

video-motion

SOP induk untuk bikin video motion/explainer bersuara via chat (9:16 Reels/TikTok, 16:9 YouTube, 1:1 feed) — menggabungkan alur kerja Motion Format (brief→gaya→naskah→ suara→adegan→render), hukum sinematik Bang Motion (video bukan slide, deterministik, gaya dari tema), dan pipeline HTML→MP4 teruji (html-motion-pipeline: faster-whisper, SFX prosedural, CDP render, audit layout, subtitle aman Reels). Gunakan bila user minta video motion/explainer/animasi/promo, atau "kayak video sebelumnya" — walau tidak menyebut "motion graphic".

関連スキル