Communitygithub.com

rbrown101010/codex-marketing-skills

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

codex-marketing-skills とは?

このスキルは、HyperFrames環境でGSAPアニメーションを記述するための包括的なリファレンスを提供します。`gsap.to()`、`gsap.from()`、`gsap.fromTo()`などのコアトゥイーンメソッド、イージング関数、スタッガーオプション、そして`gsap.timeline()`を使ったタイムライン制御(位置パラメータ、ラベル、ネスト、再生制御)について詳しく解説します。パフォーマンス向上のため、トランスフォームと不透明度を優先し、`will-change`や`gsap.quickTo()`の使用を推奨しています。また、レスポンシブ対応やアクセシビリティのための`gsap.matchMedia()`の使い方もカバー。プロパティ名はキャメルケースを使用し、レイアウトプロパティのアニメーションを避けるなど、ベストプラクティスに従った効率的なアニメーション作成を支援します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/hyperframes-gsap

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

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

ドキュメント

GSAP

コアトゥイーンメソッド

  • gsap.to(targets, vars) — 現在の状態からvarsへアニメーション。最も一般的。
  • gsap.from(targets, vars) — varsから現在の状態へアニメーション(エントランス)。
  • gsap.fromTo(targets, fromVars, toVars) — 明示的な開始と終了。
  • gsap.set(targets, vars) — 即座に適用(duration 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 in %
scale、scaleX、scaleYscale
rotationrotate (deg)
rotationX、rotationY3D rotate
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 — すべての子トゥイーンにマージされるvars。

タイムラインのネスト

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を使用します。

クリーンアップ

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


リファレンス(オンデマンドロード)

  • references/effects.md — ドロップインエフェクト:タイプライターテキスト、オーディオビジュアライザー。HyperFrames用の既製エフェクトパターンが必要なときに参照。

ベストプラクティス

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

禁止事項

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

Individual skills in this repo

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

関連スキル