Communitygithub.com

simpletibr/simplicio-loop-marketing

HTMLをソース・オブ・トゥルースとするモーションコンポジション(キネティックタイポグラフィ、モーションクォートカード、プログラムデータビジュアライゼーションリール)を作成し、HyperFramesレンダラーに渡します。ルーティングマトリックスが`hyperframes`と解決した場合に使用されます。

simplicio-loop-marketing とは?

HyperFramesは、HTMLをMP4に変換するレンダラー(Apache 2.0ライセンス)です。このスキルは、マーケティングエンジンのディスパッチャーである`hyperframes-prompt-builder`によって呼び出され、実際のオーサリングルールを定義します。HTMLファイルに`data-start`、`data-duration`、`data-track-index`属性を付与し、ヘッドレスChromeを通じてフレーム正確にタイムラインを駆動、フレームをFFmpegにパイプすることで動画を生成します。このスキルは、`motion-typography`(キネティックタイポグラフィ)、`data-viz-reel`(データ可視化リール)、`programmatic-short`(プログラムによるショート動画)といったタスクに使用され、変数によって決定論的な出力を実現します。例えば、同じ週次KPIリールを異なる数値で再レンダリングする場合などに最適です。オーサリングのプロセスは、ブランドコンテキストの読み取り、ナラティブアークの計画、レイアウト先行のアニメーション設計、フレームワーク駆動のタイムライン管理、シーン間のトランジション設定、ローカル検証、マニフェスト出力を含みます。すべてのアニメーションは`gsap.from()`による開始アニメーションを持ち、タイムラインは`window.__timelines`に登録され、`Math.random()`や`Date.now()`の使用は禁止されています。変数は`data-composition-variables`として宣言し、同じコンポジションを異なるピースで再利用可能にします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/hyperframes

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

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

ドキュメント

HyperFrames

HyperFrames は HTML → MP4 レンダラー(Apache 2.0)です。コンポジションは平易な HTML ファイルで、data-start、data-duration、data-track-index 属性を持ちます。レンダラーはヘッドレス Chrome でタイムラインをフレーム正確に駆動し、フレームを FFmpeg にパイプします。スキル hyperframes-prompt-builder がマーケティングエンジンのディスパッチャエントリポイントであり、このスキルはオーサリングルールを担います。

呼び出すタイミング

  • ピースが(PROVIDERS.md またはフロントマターの provider_override.video: hyperframes を介して)HyperFrames プロバイダにルーティングされた場合。
  • タスクが motion-typography、data-viz-reel、programmatic-short、または宣言された変数から決定論的な出力を必要とするコンポジション(例:新しい数値で再レンダリングしても変わらない週次 KPI リール)の場合。
  • 承認済みの静止画(クォートカード、カルーセルスライド)をタイポグラフィシステムを変更せずに短いモーションピースに昇格する必要がある場合。
  • オーケストレータが再レンダリング可能なアーティファクトを必要とする場合:同じコンポジション、異なる --variables、バイト同一のベースライン。

入力

  • composition_id: 文字列。プロジェクトディレクトリと data-composition-id に使用する短いスラッグ。
  • aspect: 9:16 | 1:1 | 16:9 | 4:5。
  • duration_seconds: 整数。コンポジションの全長。
  • scenes: 配列。各 { id, start_s, duration_s, role: "hook" | "body" | "cta", copy?, asset_ref? }。
  • design_tokens: オブジェクト。ブランドカラー、プライマリ/セカンダリのフォントファミリ、スペーシングスケール。存在する場合は clients/<slug>/design.md から取得。
  • variables: 配列、省略可能。呼び出し元がレンダリング時にオーバーライドできる宣言パラメータ { id, type, label, default }。
  • assets: オブジェクト、省略可能。{ video?, audio?, images[] } — プロジェクト下のローカルパス。
  • output_dir: 文字列。レンダラーが MP4 を書き込む場所(デフォルトは outputs/<client>/<date>/<piece-id>/)。

プロセス

  1. まずブランドコンテキストを読み取る。 clients/<active-client>/design.md(または渡されたデザイントークン)をロードする。トークンがわかるまでは HTML のオーサリングを拒否する — クライアントにトークンがない場合のみ、リポジトリ内のデフォルトにフォールバックする。
  2. ナラティブアークを声に出して計画する(シーン、リズム、トランジション、ビート)前にマークアップを書く。フックを最初の 1.5 秒に、ボディ、CTA を末尾に配置。
  3. アニメーションの前にレイアウトを決める。 最終的なオンスクリーンレイアウトを最初に書く — 要素が最終的に配置される位置に配置する。それらの位置に gsap.from() でアニメーションする;最終シーンのみ gsap.to() による退出が許可される。
  4. HTML を作成する。 ルート <html> は data-composition-id、data-width、data-height を持つ。各クリップは id、data-start、data-duration、data-track-index を持つ。data-composition-variables(<html> 上の JSON 配列)でパラメータ化する;実行時に window.__hyperframes.getVariables() で読み取る。
  5. すべてのタイムラインを一時停止状態で登録する。 const tl = gsap.timeline({ paused: true }); window.__timelines["<id>"] = tl; — フレームワークが再生を駆動する。無限ループ、Math.random()、時間ベースのロジック、非同期タイムライン構築は禁止。
  6. すべてのシーン間にトランジションを設定する。 ジャンプカットは禁止。上流の references/transitions.md にリストされているカタログ化されたトランジション(フェード、ワイプ、マスク、シェーダー)を使用する。
  7. ビデオとオーディオ。 <video> はミュート必須;オーディオは別の <audio> 要素に、独自のトラックとして配置する。
  8. ローカルで検証する 最初に npx hyperframes lint を実行し、次に npx hyperframes inspect(テキストオーバーフロー、コンテナクリッピング)を実行する。両方がパスしてからのみレンダリングする。hyperframes-cli スキルに委任される。
  9. マニフェストを出力する。 MP4 の横に manifest.json を書き込む。内容:{ composition_id, aspect, duration_seconds, variables_resolved, lint_pass, inspect_pass, render_settings }。CLAUDE.md の完了定義で必須。

出力

  • project_path: 文字列。HyperFrames プロジェクトディレクトリへのパス。
  • composition_html: 文字列。作成された index.html の内容(または project_path 下のそのパス)。
  • render_args: オブジェクト。npx hyperframes render に渡すフラグ(--fps、--quality、--variables、--strict)。
  • expected_artifact: 文字列。レンダリング後に output_dir 下に現れる MP4 のパス。
  • cost_estimate_usd: 数値。ローカルレンダリング — 計算時間のみ;DRY_RUN の場合は 0 を報告し、それ以外は --workers × 時間から見積もる。

譲れないルール

  • すべての要素に開始アニメーション(gsap.from())があること。
  • すべてのタイムラインは一時停止状態で開始し、window.__timelines に登録されること。
  • コンポジションロジック内で Math.random()、Date.now()、setTimeout 駆動のアニメーションは禁止。
  • ビデオトラックはミュート;<video> にオーディオを埋め込まない。
  • クライアントのコピーを直接マークアップに焼き付けず、可能な場合は変数として宣言し data-composition-variables に配置すること。これにより、同じコンポジションを新しいピースで再レンダリングできる。
  • outputs/ 下のレンダリング済み MP4 を編集せず、代わりに hyperframes render を再実行すること。

例

例1: 週次 KPI リール(programmatic-short)

入力: { composition_id: "kpi-weekly-w21", aspect: "9:16", duration_seconds: 12, scenes: [{ id: "hook", start_s: 0, duration_s: 2, role: "hook", copy: "Semana 21" }, { id: "metric", start_s: 2, duration_s: 8, role: "body" }, { id: "cta", start_s: 10, duration_s: 2, role: "cta", copy: "Veja o detalhamento" }], variables: [{ id: "leads", type: "number", label: "Novos leads", default: 0 }, { id: "delta_pct", type: "number", label: "Variação %", default: 0 }] } 出力: outputs/<client>/<date>/kpi-weekly-w21/ 下のプロジェクト。index.html が 2 つの数値変数を読み取りアニメーション化する;render_args.--variables がピースごとにそれらを解決する。

例2: モーションクォートカード(motion-typography)

入力: { composition_id: "quote-marcos-2026-05", aspect: "1:1", duration_seconds: 6, scenes: [{ id: "main", start_s: 0, duration_s: 6, role: "body", copy: "Coloque a sua marca onde os olhos já estão." }] } 出力: アクティブなクライアントのタイポグラフィペアリングを尊重するキネティックタイプのコンポジション。マスクテキストのエントランスと、最終フレームでのソフトホールドを伴う。

障害モード

  • design.md がなく、デザイントークンも渡されていない:停止して尋ねる。パレットを独自に作成しない。
  • npx hyperframes lint がエラーを報告する(data-composition-id の欠落、トラックの重複、未登録のタイムライン):修正されるまでレンダリングをブロックする。
  • npx hyperframes inspect が任意のシーンでテキストオーバーフローを報告する:システム最小値以下にタイプを縮小するよりも、レイアウトのリフローを優先する。
  • オーディオトラックがコンポジションの duration_seconds より長い:オーディオをトリミングし、duration_seconds を拡張して合わせない。
  • コンポジションが Math.random() またはウォールクロック時間をどこかで使用している:レンダリング前に、宣言された変数またはシード指定の決定論的ジェネレーターにリファクタリングする。

関連スキル

  • hyperframes-cli: lint、inspect、preview、render コマンド。オーサリング後は常に呼び出される。
  • hyperframes-prompt-builder: マーケティングエンジンのスペシャリストで、ピースのブリーフをこのスキルが期待する入力形状に変換する。マトリックスが hyperframes と解決したときに video-prompt-builder によって呼び出される。
  • video-prompt-builder: 汎用ディスパッチャ。
  • qa-tech-specs: レンダリングされた MP4 をプラットフォーム仕様(アスペクト、長さ、セーフエリア)に対して検証する。
  • compliance-<active client>: レンダリング後に、レンダリングされたアーティファクトと変数から解決されたオンスクリーンコピーに対して実行される。

上流リファレンス

完全な上流スキル(コンポジションパターン、トランジションカタログ、オーディオリアクティブ、キャプション、データインモーション):https://github.com/wesleysimplicio/hyperframes/tree/main/skills/hyperframes

Individual skills in this repo

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

関連スキル