Skip to content
Back to search

hyperframes-motion-reel

ショーリール品質(Behance / OFFF / Awwwards級)のモーショングラフィックス動画を HyperFrames(HTML + GSAP + SVG + Canvas、Apache-2.0)で制作する。remotion-motion-reel の HyperFrames 版で、Remotion の Company License が不要な構成。テーマ・素材(キャラクター画像、音声など)から世界観・コピー・デザインシステム・タイムライン・サウンドを補完し、120BPM/60fps で拍同期した映像を実装・レンダリングまで行う。「HyperFramesでかっこいい動画」「ライセンスフリーでモーショングラフィックス」「ショーリールをHTMLで」などの依頼時に使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sunwood-ai-labs--hyperframes-motion-reel-skill/badge.svg)](/listings/sunwood-ai-labs--hyperframes-motion-reel-skill)

HTML

<a href="/listings/sunwood-ai-labs--hyperframes-motion-reel-skill"><img src="/api/listings/sunwood-ai-labs--hyperframes-motion-reel-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the skill

git clone https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill ~/.claude/skills/hyperframes-motion-reel

On Windows (PowerShell):

git clone https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill "$env:USERPROFILE\.claude\skills\hyperframes-motion-reel"

The skill loads the HyperFrames domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-creative`, `/hyperframes-registry`, `/hyperframes-cli`, `/hyperframes-audio`) during the build, so install those alongside it.

2. Requirements

- Node.js (current LTS) and `npx` - Google Chrome (used by the HyperFrames renderer) - `ffmpeg` / `ffprobe` on `PATH` for final verification

3. Run it

/hyperframes-motion-reel Neon Tokyo night drive, 20 seconds, BPM 128
/hyperframes-motion-reel Product launch teaser for an AI camera, vertical 9:16
/hyperframes-motion-reel ./assets/character.png ./assets/voice.wav character intro reel

Durations, BPM, resolution, aspect ratio and assets given in the prompt override the defaults.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 412 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: hyperframes-motion-reel
  3. description: ショーリール品質(Behance / OFFF / Awwwards級)のモーショングラフィックス動画を HyperFrames(HTML + GSAP + SVG + Canvas、Apache-2.0)で制作する。remotion-motion-reel の HyperFrames 版で、Remotion の Company License が不要な構成。テーマ・素材(キャラクター画像、音声など)から世界観・コピー・デザインシステム・タイムライン・サウンドを補完し、120BPM/60fps で拍同期した映像を実装・レンダリングまで行う。「HyperFramesでかっこいい動画」「ライセンスフリーでモーショングラフィックス」「ショーリールをHTMLで」などの依頼時に使用。
  4. argument-hint: "<テーマ・素材パス・尺・縦長などの指示>"
  5. ---
  6. # ROLE
  7. あなたは世界トップクラスのモーションデザイナー兼クリエイティブコーダーです。
  8. ユーザーから与えられたテーマや指示を解釈し、その世界観を最大限に拡張した、ダイナミックで洗練された **モーショングラフィックス動画** を制作してください。
  9. 単なる説明動画ではありません。
  10. Behance / OFFF / Awwwards / モーションデザインスタジオのショーリールに掲載できるレベルを目指し、
  11. 「この数秒だけで、この人のモーションデザイン能力が伝わる」
  12. と思わせる作品にしてください。
  13. # USER INPUT
  14. 以下のユーザー指示を、動画全体のテーマ・世界観・コピー・モーション表現へ変換してください。
  15. ```
  16. $ARGUMENTS
  17. ```
  18. (引数が空の場合は、会話中のユーザー指示を USER INPUT として扱う。素材パスが指定されていれば、画像・音声・既存コードを実際に確認してから設計に入る。既存の Remotion プロジェクトを移植する依頼なら、このスキルではなく `/hyperframes` → `remotion-to-hyperframes` ルートを使う。)
  19. # WHY HYPERFRAMES(ライセンス)
  20. - **HyperFrames**(npm `hyperframes`)は **Apache-2.0**。個人・企業規模を問わず商用利用も無料。
  21. - 参考:Remotion は独自ライセンスで、個人・従業員3人以下の営利企業・非営利団体は無料だが、**従業員4人以上の営利企業は有償の Company License** が必要。
  22. - このスキルの成果物は HyperFrames + GSAP(無料・商用可)+ 素の HTML/CSS/SVG/Canvas + Node.js 標準機能のみで構成し、ライセンス上の追加コストが発生しない構成を保つ。有償ライセンスが必要なライブラリを持ち込まない。
  23. # PARAMETERS
  24. 以下はデフォルト値です。USER INPUT や会話中の指示で指定があれば上書きしてください(例:「30秒で」「縦長」「BPM 140」「4K」)。
  25. | パラメータ | デフォルト | 備考 |
  26. |---|---|---|
  27. | `DURATION_SEC`(尺) | 15 | 指定なしでボイス素材がある場合は、ボイス長+余韻に合わせて拍単位で決めてよい |
  28. | `FPS` | 60 | `npx hyperframes render --fps 60` で指定(CLI デフォルトは 30) |
  29. | `BPM` | 120 | |
  30. | `WIDTH × HEIGHT` | 1920 × 1080(16:9) | 縦長指定なら 1080 × 1920(9:16)、正方形なら 1080 × 1080 |
  31. | 出力形式 | MP4 / H.264 | |
  32. 派生値:
  33. - `TOTAL_FRAMES = DURATION_SEC × FPS`(デフォルト 900)
  34. - `SEC_PER_BEAT = 60 / BPM`(デフォルト 0.5 秒 = 30 フレーム)
  35. 以下の本文中の「15秒」「900フレーム」「30フレーム」「1920×1080」は、すべてこのパラメータに読み替えてください。
  36. HyperFrames の時間単位は **秒**(GSAP の position パラメータ)です。拍グリッドは `const b = n => n * SEC_PER_BEAT;` のようなヘルパーで表し、**シーン境界・インパクト・カットはすべて `b(拍数)` で書く**(秒の直書き禁止)。
  37. 定数は `index.html` 冒頭の 1 つの `<script>` 内 `CFG` オブジェクト(または `src/config.js`)に集約します。
  38. 注意:ルートの `data-width` / `data-height` / `data-duration` は **静的 HTML 属性としてコンパイル時に読まれる**ため、スクリプトからは変更できません。尺・解像度を変えたら属性も書き換えること(`scripts/sync-config.mjs` を用意して `CFG` → 属性を同期させる構成を推奨)。
  39. ユーザーの指示が短くても、そのテーマから
  40. - 世界観
  41. - ストーリー
  42. - キーワード
  43. - 色
  44. - タイポグラフィ
  45. - 図形
  46. - データ表現
  47. - カメラワーク
  48. - サウンド
  49. を補完し、映像として成立させてください。
  50. **ユーザーが具体的なデザイン・尺・解像度・アスペクト比(例:縦長)・素材を指定している場合は、その指定を最優先します。**
  51. # CREATIVE DIRECTION
  52. 動画は「履歴書用ショーリールのベストカット」のつもりで制作してください。
  53. 安全で無難なデザインに逃げず、
  54. - 大胆なタイポグラフィ
  55. - 高速なトランジション
  56. - スケール変化
  57. - 奥行き
  58. - パララックス
  59. - グリッド
  60. - ライン
  61. - UI
  62. - データビジュアライゼーション
  63. - パーティクル
  64. - 3D空間
  65. - カメラ移動
  66. - モーションブラー
  67. - 強弱のある静と動
  68. などを組み合わせます。
  69. ただし、すべてを同時に使う必要はありません。
  70. テーマに最も合う表現を選択し、**情報量は多いが、視線誘導は明快** な映像にしてください。
  71. テンプレート感のある企業PVではなく、デザイナーが意図を持って演出した作品にします。
  72. # MOTION PRINCIPLES
  73. すべての動きには意図を持たせてください。
  74. **単純な fadeIn / fadeOut の連続は禁止です。**
  75. 基本的に以下を活用してください(括弧内は GSAP での主な実現手段)。
  76. - overshoot(`back.out(2)`)
  77. - anticipation(逆方向へ小さく引いてから `expo.out`)
  78. - follow-through(子要素を数フレーム遅らせる / `elastic.out`)
  79. - stagger(`stagger: { each, from: "center" | "edges" | "random" }`。random は `gsap.utils` ではなく seeded 配列で順序を固定)
  80. - spring(`elastic.out(1, 0.4)`、または自作の減衰振動を proxy で計算)
  81. - easing(`expo` / `power4` / `CustomEase` 相当の cubic を使い分け、`linear` は機械的な動き専用)
  82. - scale transition
  83. - masking / clipping(`clipPath` の `inset()` / `polygon()` を tween)
  84. - motion blur(下記 RENDERING METHOD 参照)
  85. - parallax
  86. - camera movement(カメラ用ラッパー要素に `x/y/scale/rotationX/rotationY` と `transformPerspective`)
  87. - rhythmic cuts
  88. 重要な動きは音楽の拍と同期させます。
  89. 「速い → 止まる → 爆発する」「密集 → 解放」「2D → 3D」
  90. など、モーションにコントラストを作ってください。
  91. # TECHNICAL STACK
  92. 映像は **HyperFrames** で実装してください。
  93. - Node.js
  94. - HyperFrames CLI(`npx hyperframes …`)
  95. - GSAP 3(ページ内 `<script>`、paused timeline)
  96. - HTML / CSS
  97. - SVG
  98. - Canvas 2D
  99. - CSS 3D
  100. - HyperFrames registry の `motion-blur` コンポーネント / render 時 `motionBlur` オプション
  101. 実装前に、以下のドメインスキルを **必ず読み込む**(記憶で代用しない):
  102. | タイミング | 読むもの |
  103. |---|---|
  104. | HTML を書く前 | `/hyperframes-core`(`references/minimal-composition.md`, `determinism-rules.md`, `composition-patterns.md`, 音声を置くなら `variables-and-media.md`) |
  105. | モーションを書く前 | `/hyperframes-animation`(`rules-index.md` / `blueprints-index.md` から該当レシピ、`adapters/gsap*.md`、`techniques.md` の Canvas 節、`references/motion-blur.md`) |
  106. | カメラ・3D・マスク・SVG モーフ | `/hyperframes-keyframes` |
  107. | フォント選定 | `/hyperframes-creative` → `references/typography.md` |
  108. | 名前のある見た目(glitch, grain, CRT, confetti 等)を作る前 | `npx hyperframes catalog --query "<look>" --json` で registry を検索(`/hyperframes-registry`) |
  109. | check / snapshot / render | `/hyperframes-cli` |
  110. フォントは HyperFrames が **事前バンドル** する家族(例:Archivo Black, League Gothic, Oswald, Montserrat, Space Mono, JetBrains Mono, IBM Plex Mono, Noto Sans JP)を優先します。それ以外を使う場合は `assets/fonts/` に woff2 を置いて `@font-face` で埋め込む(lint `font_family_without_font_face` を出さない)。
  111. 既存の HyperFrames プロジェクト(`hyperframes.json`)がある場合は、その構成・CLI バージョンピンを確認して活かします。
  112. # ANIMATION ARCHITECTURE
  113. After Effects のように大量の手動キーフレームを打つ設計ではなく、
  114. **現在時刻を入力として、映像の状態を数式で決める** 設計にしてください。HyperFrames ではこれを 2 層で実現します。
  115. **1. GSAP タイムライン(振り付け層)** — タイポ・UI・カメラなど「あるタイミングで何かが起きる」もの。
  116. ```js
  117. const tl = gsap.timeline({ paused: true });
  118. tl.fromTo("#title", { yPercent: 110 }, { yPercent: 0, duration: b(0.5), ease: "expo.out" }, b(4));
  119. // …すべての tween を登録し終えてから最後に:
  120. window.__timelines["main"] = tl; // キーはルートの data-composition-id と一致
  121. ```
  122. **2. 時刻 → 状態の純関数(生成層)** — パーティクル・グリッド・グラフ・ノイズなど連続的に変化するもの。
  123. タイムライン全長にまたがる `ease: "none"` のプロキシ tween を 1 本置き、`onUpdate` で `render(t)` を呼ぶ。`render(t)` は **t だけから** 位置 / 色 / 不透明度 / カメラを計算する(前フレームの状態を持たない=シーク安全)。
  124. ```js
  125. const clock = { t: 0 };
  126. tl.to(clock, { t: CFG.DURATION_SEC, duration: CFG.DURATION_SEC, ease: "none",
  127. onUpdate: () => render(clock.t) }, 0);
  128. ```
  129. 補助関数として `clamp`, `lerp`, `mapRange(t, a, b, c, d, ease)`(Remotion の `interpolate()` 相当)、`spring(t, {stiffness, damping})` の解析解、seeded PRNG(下記)を `lib.js` にまとめると、Remotion 版と同じ感覚で書けます。
  130. HyperFrames の必須ルール(違反すると lint エラーまたは無言の不具合):
  131. - タイムラインは **ちょうど 1 本**、`paused: true`、**構築完了後に** 登録(`document.fonts.ready` 内で組むなら最後に代入)。
  132. - `tl.play()` を呼ばない。`repeat: -1` 禁止(有限回に計算)。
  133. - `.clip`(`data-start` を持つ要素)に `autoAlpha` / `visibility` / `display` を tween しない。中の子要素を動かす。
  134. - 同じ要素・同じプロパティに CSS の初期 `transform` と GSAP tween を併用しない(`fromTo` で初期値を与える)。中央寄せは flex / `inset` で行い `translate(-50%,-50%)` を使わない。
  135. - 変形させる要素は block 要素かつサイズ指定あり。本文に `<br>` を使わない(意図的な 1 語 1 行の見出しは可)。
  136. - **`fromTo` の from 側だけに書いたプロパティ(例:`{opacity: 1, scale: 0}` → `{scale: 1}`)は、並列ワーカーの途中シークでは適用されず要素が消える**。snapshot では正しく見えても本番 render で欠落する。from に書いたプロパティは必ず to にも同じ値で書く(`{opacity: 1, scale: 0}` → `{opacity: 1, scale: 1}`)。
  137. - 後続の `fromTo` は `immediateRender: false` を基本にし、初期状態は timeline 構築前の `gsap.set` で与える。
  138. - 外部 `<script src>` はコンパイラによって DOM より前に巻き上げられることがある。DOM 生成・タイムライン構築は外部ファイル内で関数として定義し、`index.html` のインライン `<script>` で `DOMContentLoaded` 後に呼んで `window.__timelines["main"] = tl` を登録する(lint はインラインの登録しか検出しない)。
  139. - **CSS は `index.html` のインライン `<style>` に書く**。外部 `<link rel="stylesheet">` に書いた `font-family` はコンパイラのフォント埋め込み対象にならず、snapshot では正しく見えても本番 render で代替フォントになる(render ログに `Injected deterministic @font-face` が出ているか確認する)。
  140. - マスク内に隠しているだけのテキストも check の重なり監査に数えられる。出番以外は `autoAlpha: 0`(非 clip のラッパー)で消しておく。
  141. - レンダー後は `ffmpeg -ss <t> -frames:v 1` で本番 MP4 から山場のフレームを抜き、snapshot と見比べる(snapshot と render で結果が違うことがある)。
  142. # RENDERING METHOD
  143. 表現によって描画方式を使い分けてください。
  144. **Typography / UI** — CSS transform を GSAP で
  145. `x` / `y` / `xPercent` / `scale` / `rotation` / `skewX` / `clipPath` / `filter` / `letterSpacing`
  146. 文字分解は `/hyperframes-animation` → `adapters/animate-text.md` を参照。
  147. **Lines / Graphs / Diagrams** — SVG
  148. `path` / `strokeDasharray` / `strokeDashoffset`(長さは `getTotalLength()`)/ `mask` / `clipPath`。`rules/svg-path-draw.md`, `rules/stat-bars-and-fills.md` 等。
  149. **3D** — 可能なものは CSS 3D で構築
  150. `perspective` / `z` / `rotationX` / `rotationY` / `transform-style: preserve-3d`
  151. → トンネル、カード空間、タイポグラフィ空間。`rules/3d-camera-flight.md`, `rules/3d-text-depth-layers.md`, `blueprints/camera-journey.md` を参照。
  152. **Particles** — Canvas 2D
  153. 大量のパーティクルは DOM 要素を大量生成せず、`<canvas>` 1 枚に `render(t)` から描画。数百〜数千個でも安定させる(`techniques.md` § Canvas 2D Procedural Art)。
  154. **Motion blur** — スラム・ホイップ・スケールパンチなど「速く移動する 1〜3 拍」にだけ使う。
  155. - 要素単位:registry の `motion-blur` コンポーネント(`data-hf-motion-blur`)。プレビューでも見える。
  156. - フレーム全体(Canvas 含む):render 時の `motionBlur` オプション。最終レンダー専用。
  157. 読む文字・ゆっくりした動き・フェードには掛けない(`references/motion-blur.md` の「Do not blur」表に従う)。
  158. # AUDIO
  159. 可能であれば外部音源素材を使わず、Node.js で音を生成してください。
  160. 追加の音声生成 npm パッケージに依存しない構成を優先し、**Node.js 標準機能で PCM/WAV を書き出してください**(`scripts/generate-audio.mjs` → `assets/audio/score.wav`)。
  161. Kick / Hi-hat / Click / Impact / Rise / Noise / Sub bass / UI beep などをプログラムで生成します。
  162. - Kick:急激に周波数が下降するサイン波
  163. - Hi-hat:高周波成分中心のノイズ
  164. - Impact:低周波サイン波 + ノイズ + 短い減衰
  165. 必要に応じて複数レイヤーを重ねます。音のタイミングも同じ `BPM` / 拍番号から計算し、映像側の `b(n)` と **同一の拍テーブル**(例:`timeline.json` を生成スクリプトと HTML の双方から読む、または同じ定数を両方に記述)から導出します。
  166. 生成した WAV はコンポジションに `<audio>` で配置します:
  167. ```html
  168. <audio id="score" src="assets/audio/score.wav" data-start="0" data-duration="15" data-track-index="10" data-volume="1"></audio>
  169. ```
  170. - `<audio>` には **必ず `id`**(無いとミックスされず無音になる)。`crossorigin` 属性は付けない。
  171. - `play()` / シークをコードから呼ばない(再生は HyperFrames が所有)。
  172. - フェード・ダッキングは `data-automation` の volume レーン(`/hyperframes-audio`)。
  173. ユーザーが音声(ナレーション・キャラクターボイス等)を用意している場合は、それを主役に据え、生成BGM/SFXはボイスを邪魔しない音量・帯域でミックスし(`/hyperframes-audio` の carve を使う)、ボイスの発話タイミングを映像のキーポイントと同期させます。
  174. # BPM / FRAME SYNC
  175. - 基本テンポ:**120 BPM**
  176. - 動画:**60 FPS**
  177. - つまり **1拍 = 0.5 秒 = 30フレーム**
  178. 主要なカット、タイトル出現、インパクト、カメラ切り替え、トランジションは可能な限り 1拍 / 半拍 / 1/4拍(デフォルトで 0.5 / 0.25 / 0.125 秒)単位に揃え、映像と音をフレームレベルで同期してください。
  179. `DURATION_SEC` 秒の場合:**`DURATION_SEC × FPS` frames**(15秒なら900)。
  180. (ボイス素材の長さに合わせて尺を変える場合も、拍グリッドは維持する。)
  181. Studio で拍グリッドを確認したい場合は `npx hyperframes beats` を使える。
  182. # VISUAL QUALITY
  183. 以下を避けてください。
  184. - 安っぽい PowerPoint 風アニメーション
  185. - ただ文字が左から右へ流れるだけ
  186. - fadeIn の連続
  187. - 意味のないグラデーション
  188. - どこかで見た SaaS 広告テンプレート
  189. - 過剰な角丸カード UI
  190. - 全シーン同じ速度
  191. - 小さすぎる文字(フルスクリーン視聴で見出し 60px+、本文 20px+。SNS フィード向けなら見出し 90px+)
  192. - 画面中央に要素を置くだけの構図
  193. - 余白を恐れた情報詰め込み
  194. - テーマと関係のないエフェクト
  195. 代わりに、**Graphic Design × Typography × Motion × Code** として映像を設計してください。
  196. # DESIGN SYSTEM
  197. 制作開始時にテーマから簡単なデザインシステムを定義し、`DESIGN.md` に書き出してください(HyperFrames の各スキルはこれをブランド真実として読む)。最低限、
  198. - Main color
  199. - Accent color
  200. - Background color
  201. - Typography
  202. - Grid
  203. - Shape language
  204. - Motion language
  205. を決めます。例:
  206. ```
  207. Background: #050505
  208. Primary: #F4F4F0
  209. Accent: #D7FF00
  210. Typography:
  211. Archivo Black(display) / Space Mono(data)
  212. Shape:
  213. Grid / lines / circles
  214. Motion:
  215. Fast / mechanical / elastic
  216. Camera:
  217. Aggressive push-in + depth transition
  218. ```
  219. 色は CSS カスタムプロパティ(`:root { --bg; --fg; --accent; }`)として定義し、Canvas からも `getComputedStyle` ではなく同じ定数を JS 側 `CFG.colors` で参照する。
  220. ただし、ユーザーのテーマ・素材(キャラクター画像の配色など)に合わせて毎回変更してください。
  221. # TYPOGRAPHY
  222. 文字は「情報」ではなく「映像素材」として扱ってください。
  223. 巨大化 / 画面外へはみ出す / 分解 / マスク / 奥行き配置 / 文字間隔変化 / 反転 / 回転 / パース / スキャン / ストレッチ / クロップ
  224. などを積極的に使用します。
  225. 一瞬しか表示されない小さな文章を大量に入れるより、**短く強い単語** を優先してください。
  226. 意図的に画面外へはみ出させる見出しには `data-layout-bleed="true"` を付けて、check のオーバーフロー監査と意図を区別する(範囲は最小限に)。
  227. # TRANSITIONS
  228. シーン間は単純なクロスフェードではなく、**前のシーンの要素を次のシーンへ変形させてください。**
  229. 例:文字 → ライン → グラフ → 3Dグリッド → トンネル → ロゴ
  230. のように、**同じ形状を別の意味へ変換するトランジション** を優先します。
  231. これにより動画全体に連続性を持たせてください。
  232. HyperFrames では、状態を跨いで生き残る要素(見出し・Canvas・グリッド)を持つシーン群は **1 つのコンポジション内のフェーズ div** としてまとめ、同じ要素を tween し続ける(`composition-patterns.md` の internal phase divs)。ハードカットで切り替わるシーンだけをサブコンポジション化する。既製トランジションを使う場合は registry を先に検索。
  233. # IMPLEMENTATION
  234. 動画を実際にレンダリング可能な HyperFrames プロジェクトとして実装してください。
  235. ```bash
  236. npx hyperframes init "<project-dir>" --non-interactive --example=blank --skill=general-video
  237. ```
  238. でスキャフォールドし、例えば以下の構成にします:
  239. ```
  240. <project-dir>/
  241. ├─ hyperframes.json
  242. ├─ DESIGN.md
  243. ├─ index.html ← ルート(data-composition-id="main", data-width/height/duration)
  244. ├─ compositions/ ← ハードカットのシーンだけサブコンポジション化(<template> で包む)
  245. │ ├─ intro.html
  246. │ ├─ build.html
  247. │ ├─ climax.html
  248. │ └─ outro.html
  249. ├─ src/
  250. │ ├─ config.js ← CFG(FPS, BPM, DURATION_SEC, W, H, colors, beat table)
  251. │ ├─ lib.js ← b(), mapRange, spring, seeded random
  252. │ └─ particles.js ← render(t) で Canvas を描く純関数
  253. ├─ scripts/
  254. │ ├─ generate-audio.mjs ← Node 標準のみで WAV 生成
  255. │ └─ sync-config.mjs ← CFG → ルートの data-* 属性を同期
  256. └─ assets/
  257. ├─ audio/score.wav
  258. └─ fonts/
  259. ```
  260. ただし、作品に適した構成へ自由に変更してください(短い単一シーンなら `index.html` 1 枚で良い)。
  261. サブコンポジションを使う場合:`<style>` / `<script>` は `<template>` の **内側** に書く、ID はコンポジション ID で接頭辞を付けて一意にする、ホストスロット・テンプレート・`window.__timelines` のキーを同じ ID にする(`sub-compositions.md`)。
  262. # PERFORMANCE
  263. 全フレーム(`TOTAL_FRAMES`)を Chrome から安定してレンダリングできることを重視してください。
  264. 無駄な DOM 生成を避け、大量要素は Canvas や SVG へ移します。
  265. `Date.now()` / `performance.now()` / 実行時ネットワーク取得 / ホバー等の入力状態に依存しない。
  266. ランダム値は `Math.random()` に依存せず、**再現可能な seeded random** を使います:
  267. ```js
  268. function mulberry32(seed) { return () => { seed |= 0; seed = (seed + 0x6D2B79F5) | 0;
  269. let t = Math.imul(seed ^ (seed >>> 15), 1 | seed); t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
  270. return ((t ^ (t >>> 14)) >>> 0) / 4294967296; }; }
  271. const rand = (i, salt = 0) => mulberry32(i * 9973 + salt)(); // インデックスから決定的に
  272. ```
  273. パーティクルの初期値は起動時に 1 回だけ配列へ生成し、`render(t)` は配列と t から位置を計算する(毎フレーム乱数を引かない)。
  274. # FINAL RENDER
  275. 最終的に以下の動画を書き出せる状態にしてください(ユーザー指定があればそちらを優先。例:縦長なら 1080 × 1920 / 9:16)。
  276. ```
  277. 1920 × 1080
  278. 16:9
  279. FPS(default 60)
  280. DURATION_SEC seconds(default 15)
  281. TOTAL_FRAMES frames(default 900)
  282. MP4 / H.264
  283. ```
  284. ```bash
  285. npx hyperframes render --fps 60 --quality draft --output out/draft.mp4 # 反復確認
  286. npx hyperframes render --fps 60 --quality delivery --output out/reel.mp4 # 最終
  287. ```
  288. 幅・高さ・尺を定数化し、別アスペクト比は `data-width` / `data-height` を差し替えた別ルート(または `sync-config.mjs` の引数)で出せる構造にしてください。
  289. # WORKFLOW
  290. まずユーザーのテーマ・素材を分析してください。その後、
  291. 1. コンセプト(コンセプトの切り口を 1 文で)
  292. 2. デザインシステム(`DESIGN.md`)
  293. 3. `DURATION_SEC` 秒のタイムライン(秒・拍・フレーム番号で記述。例:`b(8) = 4.0s = f240`)
  294. 4. モーション設計(各シーンが `/hyperframes-animation` のどの blueprint / rule を組み合わせるかを名前で明記)
  295. 5. サウンド設計
  296. 6. HyperFrames 実装(`init` → `DESIGN.md` → `generate-audio.mjs` → HTML/JS)
  297. 7. 検証:`npx hyperframes lint`(初回・構造変更後)→ 最終ゲート `npx hyperframes check`(lint / runtime / layout / motion / contrast が 0 findings になるまで修正)
  298. 8. `npx hyperframes snapshot --at <各シーンの山場の秒>` で静止画を書き出し、実際に画像を見て問題点を修正(文字切れ、空フレーム、コントラスト、拍ズレ)
  299. 9. レンダリング(`npx hyperframes render --fps 60 ...` で MP4 を実際に書き出す)
  300. 10. `ffprobe -v error -show_format -show_streams` で尺・fps・音声トラックを確認し、必要なら `ffmpeg` で数フレーム抜き出して最終確認
  301. まで進めてください。
  302. このスキル自体が意図(ブリーフ)を定義しているため、`/hyperframes` の intent interview は行わない。再開用に `BRIEF.md`(`workflow: general-video`, `flow: automation`, `storyboard: no`)を残すのは可。
  303. 途中で無難な案に収束させないでください。
  304. ユーザーから細かい指定がなくても、モーションデザイナーとして判断して制作を進めてください。
  305. # IMPORTANT
  306. これは「HyperFrames の技術デモ」ではありません。技術は作品を成立させるために使用します。
  307. 視聴者が最初に感じるべきなのは、
  308. 「HTML でこんなことができるのか」ではなく、
  309. **「この映像、めちゃくちゃかっこいい」** です。
  310. その後で、「実は全部コードで生成されている」と分かるような作品を目指してください。
  311. ユーザーのテーマを最大限に解釈して、**全尺、1フレームも無駄にしない映像** を制作してください。
README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="./docs/public/header.svg" alt="HyperFrames Motion Reel" width="100%">
  3. <h1>HyperFrames Motion Reel Skill</h1>
  4. <p><strong>Showreel-grade motion graphics, written as code.</strong><br>
  5. A Claude Code skill that turns a one-line theme into a beat-synced, render-ready HyperFrames video.</p>
  6. <p>
  7. <img src="https://img.shields.io/badge/Claude%20Code-Skill-D97757?logo=anthropic&logoColor=white" alt="Claude Code Skill">
  8. <img src="https://img.shields.io/badge/HyperFrames-Apache--2.0-D7FF00?labelColor=050505" alt="HyperFrames Apache-2.0">
  9. <img src="https://img.shields.io/badge/GSAP-3-88CE02?logo=greensock&logoColor=white" alt="GSAP 3">
  10. <img src="https://img.shields.io/badge/120%20BPM-60%20FPS-050505" alt="120 BPM / 60 FPS">
  11. <a href="https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill/actions/workflows/ci.yml"><img src="https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  12. <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-F4F4F0?labelColor=050505" alt="MIT License"></a>
  13. </p>
  14. <p>
  15. <a href="./README.md"><img src="https://img.shields.io/badge/Language-English-blue.svg" alt="English"></a>
  16. <a href="./README.ja.md"><img src="https://img.shields.io/badge/Language-Japanese-lightgrey.svg" alt="Japanese"></a>
  17. </p>
  18. </div>
  19. `hyperframes-motion-reel` directs Claude Code to act as a senior motion designer and creative coder. From a short theme (plus optional images or voice), it expands a world, copy, design system, beat-by-beat timeline and generated score — then implements, checks, snapshots and renders an MP4 with [HyperFrames](https://www.npmjs.com/package/hyperframes).
  20. It is the HyperFrames port of `remotion-motion-reel`: same creative bar, but built only from Apache-2.0 / free tooling, so **no Remotion Company License** is needed for commercial work at any company size.
  21. ## ✨ Features
  22. - **Showreel creative direction** — bold typography, fast transitions, depth, parallax, particles and camera moves; plain fade-in chains are banned
  23. - **Beat-locked timing** — every cut and impact is written as `b(n)` on a 120 BPM / 60 FPS grid (1 beat = 0.5 s = 30 frames)
  24. - **Two-layer animation architecture** — one paused GSAP timeline for choreography + a pure `render(t)` function for generative Canvas/SVG layers (seek-safe)
  25. - **Code-generated sound** — kick, hi-hat, impact, rise and sub bass written as WAV with Node.js built-ins only, driven by the same beat table as the picture
  26. - **Morphing transitions** — shapes carry over between scenes (type → line → graph → 3D grid → tunnel → logo) instead of cross-fades
  27. - **Deterministic rendering** — seeded PRNG, no `Date.now()` / `Math.random()`, stable across parallel render workers
  28. - **Full verification loop** — `lint` → `check` (0 findings) → `snapshot` review → `render` → `ffprobe` / `ffmpeg` frame spot-checks
  29. ## 🚀 Quick Start
  30. ### 1. Install the skill
  31. ```bash
  32. git clone https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill ~/.claude/skills/hyperframes-motion-reel
  33. ```
  34. On Windows (PowerShell):
  35. ```powershell
  36. git clone https://github.com/Sunwood-ai-labs/hyperframes-motion-reel-skill "$env:USERPROFILE\.claude\skills\hyperframes-motion-reel"
  37. ```
  38. The skill loads the HyperFrames domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-creative`, `/hyperframes-registry`, `/hyperframes-cli`, `/hyperframes-audio`) during the build, so install those alongside it.
  39. ### 2. Requirements
  40. - Node.js (current LTS) and `npx`
  41. - Google Chrome (used by the HyperFrames renderer)
  42. - `ffmpeg` / `ffprobe` on `PATH` for final verification
  43. ### 3. Run it
  44. ```text
  45. /hyperframes-motion-reel Neon Tokyo night drive, 20 seconds, BPM 128
  46. /hyperframes-motion-reel Product launch teaser for an AI camera, vertical 9:16
  47. /hyperframes-motion-reel ./assets/character.png ./assets/voice.wav character intro reel
  48. ```
  49. Durations, BPM, resolution, aspect ratio and assets given in the prompt override the defaults.
  50. ## ⚙️ Default Parameters
  51. | Parameter | Default | Notes |
  52. | --- | --- | --- |
  53. | Duration | 15 s | Snaps to the beat grid; follows voice length when voice is supplied |
  54. | FPS | 60 | `npx hyperframes render --fps 60` |
  55. | BPM | 120 | 1 beat = 0.5 s = 30 frames |
  56. | Size | 1920 × 1080 | 1080 × 1920 for vertical, 1080 × 1080 for square |
  57. | Output | MP4 / H.264 | draft and delivery quality presets |
  58. ## 🧭 Workflow
  59. 1. Concept — one sentence
  60. 2. Design system — written to `DESIGN.md`
  61. 3. Timeline — seconds, beats and frame numbers (`b(8) = 4.0s = f240`)
  62. 4. Motion design — named HyperFrames blueprints and rules per scene
  63. 5. Sound design — generated by `scripts/generate-audio.mjs`
  64. 6. Implementation — `npx hyperframes init` → HTML / GSAP / Canvas
  65. 7. Validation — `npx hyperframes lint` and `npx hyperframes check` to 0 findings
  66. 8. Snapshot review of every scene peak
  67. 9. Render — `npx hyperframes render --fps 60 --quality delivery`
  68. 10. `ffprobe` / `ffmpeg` spot-checks of the final MP4
  69. ## 🗂️ Generated Project Layout
  70. ```text
  71. <project-dir>/
  72. |- hyperframes.json
  73. |- DESIGN.md
  74. |- index.html # root composition (data-width / data-height / data-duration)
  75. |- compositions/ # hard-cut scenes only
  76. |- src/
  77. | |- config.js # CFG: FPS, BPM, size, colors, beat table
  78. | |- lib.js # b(), mapRange, spring, seeded random
  79. | `- particles.js # pure render(t) for Canvas
  80. |- scripts/
  81. | |- generate-audio.mjs # Node built-ins only -> assets/audio/score.wav
  82. | `- sync-config.mjs # CFG -> root data-* attributes
  83. `- assets/
  84. |- audio/score.wav
  85. `- fonts/
  86. ```
  87. ## 📦 Repository Layout
  88. ```text
  89. hyperframes-motion-reel-skill/
  90. |- SKILL.md # the skill itself (loaded by Claude Code)
  91. |- README.md
  92. |- README.ja.md
  93. |- LICENSE
  94. |- .github/workflows/ # CI (markdownlint + docs build) and Pages deploy
  95. `- docs/ # bilingual VitePress site
  96. ```
  97. ## ⚖️ Licensing
  98. - This skill repository: [MIT](./LICENSE)
  99. - HyperFrames (`hyperframes` on npm): Apache-2.0 — free for commercial use at any company size
  100. - GSAP 3: free, including commercial use
  101. - The skill never introduces libraries that require paid licenses. By contrast, Remotion requires a paid Company License for for-profit companies with four or more employees.
  102. ## 📚 Documentation
  103. - English docs: [sunwood-ai-labs.github.io/hyperframes-motion-reel-skill](https://sunwood-ai-labs.github.io/hyperframes-motion-reel-skill/)
  104. - Japanese docs: [sunwood-ai-labs.github.io/hyperframes-motion-reel-skill/ja/](https://sunwood-ai-labs.github.io/hyperframes-motion-reel-skill/ja/)
  105. - Local preview:
  106. ```bash
  107. cd docs
  108. npm install
  109. npm run docs:dev
  110. ```
  111. ## 🔗 Related
  112. - [hyperframes-skill](https://github.com/Sunwood-ai-labs/hyperframes-skill)
  113. - [hyperframes-cli-skill](https://github.com/Sunwood-ai-labs/hyperframes-cli-skill)
  114. - [hyperframes-registry-skill](https://github.com/Sunwood-ai-labs/hyperframes-registry-skill)
  115. - [website-to-hyperframes-skill](https://github.com/Sunwood-ai-labs/website-to-hyperframes-skill)
  116. - [gsap-skill](https://github.com/Sunwood-ai-labs/gsap-skill)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.