Communitygithub.com

heygen-com/hyperframes

HyperFramesの起動動画向けの、ハウススタイルである特大macOSカーソル技術です。シーン内でカーソルやポインターが主導するアクションがある場合、UIシーンの開始時、モーフ/トランジション/タイピング実行をクリックで起動する場合、またはシーンが静的、死んでいる、古臭く感じられ、視聴者の視線を誘導し、その状態から切り離すための安価で効果的な動きのソースが必要な場合に読み込まれます。カーソルのサイズ/外観(ブランドモチーフのカーソルを含む)、画面外からの進入ルール、先端のターゲティングとクリックタップ、クリックで次のビートを開始する方法、および終了/シーン間の引き継ぎをカバーします。

hyperframes とは?

このスキルは、HyperFrames向けの起動動画において、特大のmacOSスタイルカーソルを「目に見える主役」として活用するための一連のルールと実装詳細を提供します。このカーソルは、静的なシーンに動きをもたらし、視聴者の視線を誘導し、モーフやトランジションなどのアクションをクリックで開始する因果関係を明確にするために設計されています。主な特徴として、常に画面外から進入し、先端でターゲットを正確に指し示すこと、クリック時に非対称な圧縮/拡張アニメーションを用いること、クリックが同じフレーム内で次のアクションを引き起こすこと、そしてアクションを所有しないビート中はカーソルが脇に退くことが挙げられます。また、カーソル自体がシームをつなぐキャリア要素となる「カーブカットハンドオフ」を含む物理的な終了方法も定義されています。このスキルはmacOS標準の矢印カーソルをデフォルトとしつつ、Figma風のカラフルなマルチプレイヤー矢印など、ブランド固有のカーソルモチーフを使用するためのガイドラインも提供しており、ブランド言語を即座に認識可能にします。CSS(`filter`、`z-index`、`will-change`)とGSAPアニメーションの具体的な設定が含まれており、CursorやClaude CodeなどのAIエージェントがHyperFramesのUIアニメーションを生成する際に、この一貫した動きのルールを適用できます。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/HEAD/.agents/skills/oversized-cursor

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

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

ドキュメント

特大カーソル — 視線を運ぶ存在

意図的に大きくしたmacOSスタイルのポインターが、フレームを_目に見える主役_として移動します。画面外から進入し、視聴者の視線を次の注目ポイントへ誘導し、クリックして次のアクションを引き起こし、そして去っていきます。複数のローンチフィルムで実績のある手法です。

なぜ存在するのか。 大きなカーソルの動きは、ローンチビデオにおいて最も安価で効果的なモーションソースの1つです。1つの要素とトランスフォームのみのトゥイーンで、(1) 静的に見えるシーンに視線を導き、(2) モーフやトランジションに因果関係を与え(「そのクリックが起こした」)、(3) 新しいシーンや複雑なアニメーションシーケンスを開始する際に、視聴者の視線を古い状態から切り離します。大きい方が良いです — 実際のサイズのカーソルはビデオスケールでは見えなくなります。

サイズと外観(ハウスコンベンション)

  • フルフレームシーン: 7cqw(1920pxで約134px)。モック内/小フレームのバリアント: 4.6–5.5cqw。それより小さくしないでください。
  • どこでも同じSVG矢印ジオメトリを使用します。実績のある2つの塗りつぶし — 白い本体+黒いストローク、または黒い本体(#1c1c1c)+白いストローク(1.4px)。シーンのコントラストに応じて選び、フィルム内では一定に保ってください。
  • ブランドモチーフのカーソル(切り札)。 macOSの矢印はデフォルトであり、必須ではありません。対象ブランドに認識可能なカーソルアイデンティティがある場合 — コラボレーションデザインツールの名前タグ付きカラフルなマルチプレイヤー矢印(Figmaスタイル)、クリエイティブスイートの精密なクロスヘア、特徴的な製品ポインター — そのカーソルを使用してください。製品を知っている人には即座に理解可能なブランド言語となります。同じルールが変更されずに適用され(特大スケール、物理的な進入/終了、先端ターゲティング、クリック起動)、名前タグ付きバリアントは1つの剛体ユニットとして移動します(タグは矢印の後ろに付きます)。モチーフが本当に参照可能な場合にのみ使用してください。誰も認識できないカーソルは単なる奇妙な矢印に過ぎません — デフォルトのmacOSに戻してください。
  • filter: drop-shadow(0 4px 6px rgba(0,0,0,.3))、pointer-events: none、z-indexはすべてのシーンコンテンツの上、will-change: transform。
#root .cursor {
  position: absolute;
  left: 48%;
  top: 115%; /* 画面外下 — 静止ポーズは画面外 */
  width: 7cqw;
  height: 7cqw;
  z-index: 20;
  filter: drop-shadow(0 4px 6px rgba(0, 0, 0, 0.3));
  pointer-events: none;
  will-change: transform;
}

進入ルール — 物理的で、決して出現しない

カーソルは常に画面外から進入し(標準: 下から、top:115–120%)、最初のターゲットまで1回の減速するグライドで移動します。_部屋に入ってきた_ように感じさせる必要があります。静止位置で不透明度フェードインさせたり、マスクで出現させたりしないでください — それはグリッチのように見えます(実際に繰り返し観察された失敗モードです)。

  • デフォルトパス: Y軸に沿って真っ直ぐターゲットへ — 断片的な対角線は避けます。対角線は、それがストーリー上必要である場合(軸外のターゲットに向かって進入するなど)は問題ありませんが、いずれにしても1つの連続したベクトルです。
  • duration: 0.4–0.92s、ease: power3.out、fromToではimmediateRender: false。
tl.fromTo(
  cursor,
  { left: "48.6%", top: "115%" },
  { left: "48.6%", top: "55%", duration: 0.85, ease: "power3.out", immediateRender: false },
  0.25,
);

先端ターゲティングとクリックタップ

ホットスポットは矢印の先端であり、ボックスの中心ではありません。先端をターゲットの中心に着地させ、すべての押下スケーリングを先端を中心に行います: transformOrigin: '21% 14%'(ハウス矢印パス、24ユニットのviewBoxの場合)。

クリック = 非対称な圧縮/拡張(1:2の比率が実際のタップとして認識されます):

tl.to(cursor, { scale: 0.84, duration: 0.1, ease: "power2.in", transformOrigin: "21% 14%" }, t);
tl.to(
  cursor,
  { scale: 1, duration: 0.22, ease: "power2.out", transformOrigin: "21% 14%" },
  t + 0.1,
);

ターゲットの反応は別のパラレルトゥイーンです(ボタン: scale: 0.94 + 押下時の色/シャドウ、同じtで開始)。カーソルのみのタップ(例: テキスト入力へのフォーカス)ではターゲットの反応は不要です。ターゲット側にはcursor-click-ripple / press-release-springと組み合わせてください。

クリックが次のビートを開始する

モーフ、タイピング実行、ウィンドウ変換、またはシーンを定義するアニメーションが単に_開始_することを決して許さないでください。カーソルをトリガー上に置き、クリックがそれを同じフレーム内で引き起こすようにしてください:

  • クリック ▸ メニュー/サブメニューカスケード、トグルフリップ
  • クリック ▸ 入力へのタイピング開始
  • クリック ▸ コンポーザーのモーダウン/ウィンドウ縮小
  • クリック ▸ ロゴの発動/フライト開始
  • クリック ▸ プロダクトモック内での再生状態反転 + UIライフの起動

カーソルが所有しない長いビート(タイピング、ナレーション)の間、カーソルは脇に退きます(0.5–0.9秒、power2.out)— アクションの上に凍りついたり、無意味に揺れたりすることはありません。

終了ルールとシーン間の引き継ぎ

2つの認可された終了方法 — 両方とも物理的で、その場での不透明度フェードは禁止:

  1. フレームから去る: power2.in(left:'118%'、left:'-12%'、またはtop:'116%')で最も近い端に向かって加速、0.5~0.7秒。
  2. カーブカットハンドオフ: ハードカットの直前の約0.3秒で、カーソルは次のシーンの最初のクリックポイントに向かって加速を開始し(power2.in)、そのパスの最初の約1/3をカバーします。次のコンポジションはgsap.setでカーソルをハンドオフポーズに設定し、一致した速度でpower2.outを続けます。カーソル自体がシームをつなぐキャリア要素になります:
// シーンA、最後の0.3秒 — 旅を開始:
tl.to(cursor, { left: "40.7%", top: "63.7%", duration: 0.3, ease: "power2.in" }, CUT - 0.3);
// シーンB、t=0 — 一致した速度で完了:
gsap.set(cursorB, { left: "40.7%", top: "63.7%" });
tl.to(cursorB, { left: "22%", top: "45%", duration: 0.6, ease: "power2.out" }, 0);

チェックリスト

  • フルフレームで7cqw以上(モック内では4.6~5.5cqw)— 不明な場合は大きく
  • 1つの連続したベクトルで画面外から進入する(フェード/マスク出現なし)
  • 先端がターゲットの中心に着地する。押下はtransformOrigin: '21% 14%'を中心に行う
  • すべてのクリックが同じフレーム内で何かを引き起こす
  • 所有しないビート中は脇に退く。無意味な揺れゼロ
  • 物理的に終了する(フレーム外へ、またはカーブカットハンドオフ)— その場でのフェード禁止

Individual skills in this repo

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

general-video

>

heygen-com/animejs

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

heygen-com/claude-design-hyperframes

Use when running inside Claude Design specifically. Produces a valid, brand-accurate HyperFrames video draft using pre-valid skeletons. For Claude Code / Cursor / Codex, use the `hyperframes` skill instead.

heygen-com/contribute-catalog

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

heygen-com/css-animations

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

heygen-com/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

heygen-com/hyperframes

A tiled headline surface flips cell by cell under a sweeping depth field to reveal the rear headline. HyperFrames block, 1920×1080, 8s, 18 variables.

heygen-com/hyperframes

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

heygen-com/hyperframes

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

heygen-com/hyperframes

A single feature card orbits a dot sphere on approved Blender camera motion. HyperFrames block, 1920×1080, 10s, 4 variables.

heygen-com/hyperframes

A wireframe portal bursts open, the title comes through, then its letters swap into a second phrase. HyperFrames block, 1920×1080, 8s, 9 variables.

heygen-com/hyperframes

Glass shards fly in through fog and tile themselves into the headline. HyperFrames block, 1920×1080, 12.16s, 19 variables.

heygen-com/hyperframes

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

heygen-com/hyperframes

An orbiting camera follows an ice logo as it breaks apart, reforms into two text moments, and fades. HyperFrames block, 1920×1080, 22.5s, 216 variables.

heygen-com/hyperframes

name: embedded-captions

heygen-com/hyperframes

A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables.

heygen-com/hyperframes

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

heygen-com/hyperframes

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

heygen-com/hyperframes

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

heygen-com/hyperframes

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

関連スキル