Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFrames向けGSAPアニメーションリファレンス。gsap.to()、from()、fromTo()、イージング、スタガー、デフォルト、タイムライン(gsap.timeline()、位置パラメータ、ラベル、ネスト、再生制御)、およびパフォーマンス(トランスフォーム、will-change、quickTo)をカバーします。HyperFramesコンポジションでGSAPアニメーションを作成する際に使用します。

hyperframes-student-kit とは?

このスキルは、HyperFramesプラットフォームで動作するアニメーションライブラリGSAPの詳細なリファレンスを提供します。開発者は、gsap.to()、gsap.from()、gsap.fromTo()などのコアメソッドや、イージング、スタガー、デフォルト設定の活用方法を学べます。また、gsap.timeline()を使用したタイムラインの作成、位置パラメータによるアニメーションの正確な配置、ラベルやネストされたタイムラインを用いた複雑なシーケンスの構築方法も解説しています。パフォーマンス面では、トランスフォームと不透明度の活用、will-changeの適切な使用、gsap.quickTo()による高頻度更新の最適化、スタガーによる効率的なアニメーション、不要になったトゥイーンのクリーンアップといったベストプラクティスを強調しています。このリファレンスは、HyperFramesコンポジション内でGSAPアニメーションを記述するすべての開発者にとって、実践的で即戦力となる知識を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/gsap

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

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

ドキュメント

GSAP

コアトゥイーンメソッド

  • gsap.to(targets, vars) — 現在の状態から vars に向けてアニメーション。最も一般的。
  • gsap.from(targets, vars) — vars から現在の状態に向けてアニメーション(出現効果)。
  • gsap.fromTo(targets, fromVars, toVars) — 開始と終了を明示的に指定。
  • gsap.set(targets, vars) — 即座に適用(継続時間0)。

常にキャメルケースのプロパティ名を使用してください(例:backgroundColor、rotationX)。

共通のvars(変数)

  • duration — 秒数(デフォルト0.5)。
  • delay — 開始までの秒数。
  • ease — "power1.out"(デフォルト)、"power3.inOut"、"back.out(1.7)"、"elastic.out(1, 0.3)"、"none"。
  • stagger — 数値 0.1 またはオブジェクト:{ amount: 0.3, from: "center" }、{ each: 0.1, from: "random" }。
  • overwrite — false(デフォルト)、true、または "auto"。
  • repeat — 数値、または -1 で無限。yoyo — repeatと組み合わせて方向を反転。
  • onComplete、onStart、onUpdate — コールバック。
  • immediateRender — from()/fromTo()ではデフォルト true。同じプロパティ+要素を後からターゲットにするトゥイーンでは false に設定して上書きを回避。

トランスフォームとCSS

生の transform 文字列よりもGSAPのトランスフォームエイリアスを推奨します。

GSAPプロパティ同等のCSS
x、y、ztranslateX/Y/Z (px)
xPercent、yPercenttranslateX/Y (%)
scale、scaleX、scaleYscale
rotationrotate (deg)
rotationX、rotationY3D回転
skewX、skewYskew
transformOrigintransform-origin
  • autoAlpha — opacityよりも推奨。0の時は visibility: hidden も設定。
  • CSS変数 — "--hue": 180。
  • svgOrigin (SVGのみ) — グローバルなSVG座標空間の原点。transformOrigin とは併用しないでください。
  • 方向指定回転 — "360_cw"、"-170_short"、"90_ccw"。
  • clearProps — "all" またはカンマ区切り。完了時にインラインスタイルを削除。
  • 相対値 — "+=20"、"-=10"、"*=2"。

関数ベースの値

gsap.to(".item", {
  x: (i, target, targets) => i * 50,
  stagger: 0.1,
});

イージング

組み込みイージング:power1~power4、back、bounce、circ、elastic、expo、sine。それぞれ .in、.out、.inOut があります。

デフォルト

gsap.defaults({ duration: 0.6, ease: "power2.out" });

トゥイーンの制御

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia()(レスポンシブ + アクセシビリティ)

メディアクエリに一致する場合にのみセットアップを実行し、一致しなくなったら自動的に元に戻します。

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (context) => {
    const { isDesktop, reduceMotion } = context.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

タイムライン

タイムラインの作成

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

位置パラメータ

3番目の引数で配置を制御します。

  • 絶対指定:1 — 1秒の位置
  • 相対指定:"+=0.5" — 終了後、"-=0.2" — 終了前
  • ラベル:"intro"、"intro+=0.3"
  • 位置揃え:"<" — 前のトゥイーンと同じ開始位置、">" — 前のトゥイーンの終了後、"<0.2" — 前のトゥイーンの開始から0.2秒後
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // .aと同じ開始位置
tl.to(".c", { opacity: 0 }, "<0.2"); // .bの開始から0.2秒後

ラベル

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

タイムラインオプション

  • paused: true — 一時停止状態で作成。.play() を呼び出して開始。
  • repeat、yoyo — タイムライン全体に適用。
  • defaults — すべての子トゥイーンにマージされる変数。

タイムラインのネスト

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

再生制御

tl.play()、tl.pause()、tl.reverse()、tl.restart()、tl.time(2)、tl.progress(0.5)、tl.kill()。


パフォーマンス

トランスフォームと不透明度を優先

x、y、scale、rotation、opacity のアニメーションはコンポジター上で処理されます。width、height、top、left は、トランスフォームで同じ効果が得られる場合は避けてください。

will-change

will-change: transform;

実際にアニメーションする要素にのみ適用します。

高頻度更新には gsap.quickTo()

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

多数のトゥイーンよりもスタガー

個別のトゥイーンと手動の遅延よりも stagger を使用します。

クリーンアップ

画面外のアニメーションは一時停止または強制終了します。


参考資料(オンデマンドで読み込み)

  • references/effects.md — すぐに使えるエフェクト:タイプライター風テキスト、オーディオビジュアライザー。HyperFrames用の既製エフェクトパターンが必要な場合に参照してください。

ベストプラクティス

  • キャメルケースのプロパティ名を使用し、トランスフォームエイリアスとautoAlphaを優先。
  • delayによる連鎖よりもタイムラインを優先し、位置パラメータを使用。
  • 読みやすいシーケンスのために addLabel() でラベルを追加。
  • タイムラインコンストラクタにデフォルトを渡す。
  • 再生制御が必要な場合は、トゥイーン/タイムラインの戻り値を保存。

してはいけないこと

  • トランスフォームで十分な場合にレイアウトプロパティ(width/height/top/left)をアニメーションしない。
  • 同じSVG要素で svgOrigin と transformOrigin の両方を使用しない。
  • タイムラインでシーケンス化できる場合に delay でアニメーションを連鎖させない。
  • DOMが存在する前にトゥイーンを作成しない。
  • クリーンアップを怠らない — 不要になったトゥイーンは必ず強制終了すること。

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

関連スキル