使い方ガイドへスキップ
gsap-plugins作者 GreenSock

GSAP Plugins スキル。

Claude Code と Codex のモーション・動画スキル:GSAP プラグイン(ScrollTo、ScrollSmoother、Flip、Draggable、SplitText、SVG、物理演算)

  • モーションと動画
  • UI コード
greensock/gsap-skills · skills/gsap-plugins/SKILL.mdSKILL.md
--- name: gsap-plugins description: Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration. --- ## When to Use This Skill ## Licensing & Install (important) ## Registering Plugins ## Scroll ## DOM / UI ## Text
2026年9月14日にアップストリームファイルから読み取ったフロントマターとセクション見出し · 全21,477文字

01 できること

Claude Code と Codex における gsap-plugins スキルの役割

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

プラグイン登録と、ScrollTrigger 以外のすべてのプラグイン(ScrollTo、ScrollSmoother、Flip、Draggable、Inertia、Observer、SplitText、ScrambleText、DrawSVG、MorphSVG、MotionPath、CustomEase、EasePack、CustomWiggle、CustomBounce、Physics2D、PhysicsProps、PixiPlugin、GSDevTools)を扱う公式 GSAP スキルです。

まずライセンスについて説明します——すべてのプラグインは無料で、Club GSAP のメンバーシップや認証トークンは不要です——その後、プラグインごとの設定(Flip.from の vars、Draggable のオプション、SplitText.create の vars、morphSVG のオプション、motionPath の alignment)を示します。公開されている gsap npm パッケージからすべてをインストールし、正しい呼び出し順序、デフォルト値、注意点を必要とするデザイナーおよび開発者向けです。関連スキル:gsap-core、gsap-scrolltrigger、gsap-react。

生成されるもの

  • ウィンドウや任意のスクロール可能な要素を、ある位置やターゲットへアニメーションさせるスクロールトゥイーンです。
  • chars、words、lines を公開し、mask が設定されている場合は masks も公開する SplitText インスタンスです。
  • circle、rect、ellipse、line の代わりに DOM に差し替えられる、変換された path 要素です。
プロンプト例を見る ↗

仕組み

  1. 01
    プラグインは最初に一度だけ登録する

    各プラグインは、いずれのトゥイーンや API 呼び出しで使用される前に、GSAP とバンドラーがそれを含めるよう認識できるように、一度だけ登録します。

  2. 02
    Flip で状態を記録し、変更し、そしてアニメーションする

    Flip は3段階のシーケンスです:古い状態を読み取り、DOM を変更し、記録された状態から新しい状態へアニメーションします。

  3. 03
    ドラッグとスロー操作を作成する

    Draggable.create は type、任意の bounds と inertia を受け取り、InertiaPlugin がリリース後の運動量を提供します。

  4. 04
    テキストをアニメーション可能な単位に分割する

    SplitText は文字、単語、行をそれぞれ独自の要素に配置し、単位ごとにスタガーやアニメーションができるようにします。

  5. 05
    SVG を描画または変形する

    SVG プラグインは、描画効果のために stroke dash の値をアニメーションさせるか、ある形状を別の形状へ変形させるために path の d 属性をアニメーションさせます。

  6. 06
    イージングとフィジックスのプラグインを活用する

    イージングプラグインはカスタムカーブや名前付きイージングを追加し、フィジックスプラグインは velocity、angle、gravity の値からモーションを駆動します。

02 適合性を確認

gsap-plugins Skillを使用するタイミング

Claude CodeまたはCodexでこの種類のモーションとビデオの作業を行う場合は、gsap-pluginsスキルを使用してください。以下の適合性と制限はスキル自身のファイルから引用されています。

適している場合

  • ScrollTriggerを使わずに、要素やピクセル位置までスクロールする場合です。
  • 並び替えられたリスト、グリッド、展開・折りたたみパネルなど、2つのレイアウト状態間でアニメーションさせる場合です。
  • マウスやタッチでのドラッグ、スピン、慣性動作が必要なスライダー、カード、並べ替え可能なリストです。
  • 文字単位、単語単位、行単位でアニメーションするテキストリビールです。
  • アイコン同士のモーフィング、シェイクトランジション、その他パスベースのSVGアニメーションです。

境界を知る

  • SplitTextはSVGのtext要素を分割できません。
  • DrawSVGはストロークのみをアニメーションし、フィルは対象外です。また、use要素の内容を視覚的に変更することはできません。
  • ScrollTriggerに関する作業は、このスキルではなく別のスキルに属します。
  • text-wrap: balanceを使用したテキストは、分割との組み合わせが良くありません。

提供すべきもの

  • 登録すべきプラグインの一覧プロジェクトで使用するすべてのプラグインは、バンドラーが含められるように1回のgsap.registerPlugin呼び出しで名前を指定する必要があります。
  • ScrollSmootherのDOM構造ScrollSmootherには、ScrollTriggerに加えて、smoothラッパー内にコンテンツラッパーが必要です。fixed-positionの要素はその外側に置くことが許されています。
  • SplitTextのターゲットSplitText.createは、split用の設定に加えて、セレクタ、要素、または配列をターゲットとして受け取ります。
  • MorphSVGのシェイプ必須のshapeプロパティは、セレクタ、要素、または生のパス文字列をモーフィングの目的地として受け付けます。
  • すでに読み込まれているフォントとレイアウトカスタムフォントの場合は、読み込み完了後に分割するか、autoSplitとonSplitを利用して適切なタイミングで再分割してください。

03 スキルの内部

gsap-pluginsスキルがClaude CodeとCodexに与えるルール

SKILL.md がエージェントに設定する 8 つの具体的な指示・既定値・制限 — 結果を変える部分です。

  1. アニメーションさせる前に登録する

    プラグインは、tweenやAPI呼び出しで使用される前に登録されている必要があります。登録は失敗時の対処ではなく、最初のステップです。

  2. 公開されているgsapパッケージからインストールする

    すべての機能はnpm install gsapで提供され、gsap/SplitTextやgsap/MorphSVGPluginなどとしてインポートします。

  3. auth-token付きの.npmrcを生成しない

    GreenSockの認証トークンを含む.npmrcを作成したり、プライベートなnpm.greensock.comレジストリを指定したり、プラグインのためにユーザーにClub GSAPへの加入を勧めたりしないでください。

  4. Reactではトップレベルで登録する

    アプリ内で、たとえば最初のuseGSAP呼び出しより前に一度だけ登録してください。再レンダリングされるコンポーネントの内部では登録しないでください。useGSAP自体も、使用前に登録が必要です。

  5. アニメーションさせる部分だけを分割する

    パフォーマンスに必要なものだけを分割してください。例えば、行を使わない場合は単語や文字単位で分割します。文字のみの分割ではsmartWrapを使わないと不自然な改行が発生します。

  6. onSplit内でautoSplitアニメーションを構築する

    autoSplitがtrueの場合、アニメーションは新しく分割された要素を対象にするためonSplit内で作成し、SplitTextが元に戻して時間同期できるようにonSplitから返す必要があります。

  7. DrawSVGに描画対象を与える

    要素にはCSSまたはSVG属性としてstrokeとstroke-widthで可視のストロークを設定する必要があります。設定しないと何も描画されません。

  8. 開発専用のPluginを本番環境に含めない

    GSDevToolsは開発中のデバッグ用であり、本番には出荷してはいけません。他の開発専用Pluginも同じ規則に従います。

04 実際に使う

Claude CodeまたはCodexにgsap-pluginsをインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codexまたはあなたのエージェントにgsap-pluginsを追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/greensock/gsap-skills --skill gsap-plugins

skills/gsap-plugins/SKILL.md用の汎用skillsCLI形式です。リポジトリ側で独自のパスを文書化している場合があります。

スキルに最初のモーション・動画タスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
I'm building a filterable gallery in [framework]. Capture the state with Flip.getState() before the filter changes the DOM, then animate with Flip.from() using duration 0.5 and ease power2.inOut. Also make each card draggable inside [container selector] with inertia true so it throws when released, and register every plugin I use up front. Split the card captions into words and chars so I can stagger them.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • コンポーネントがアンマウントされたり要素が削除されたりする際は、SplitTextInstance.revert()のようなPluginインスタンスをrevertしてください。
  • shapeIndex: "log"を一度実行して自動計算された値を確認し、その数値や配列をtweenに貼り付けてください。
  • DrawSVGPlugin.getLength(element)とDrawSVGPlugin.getPosition(element)でストロークを計測してください。
  • MotionPathHelperで視覚的にMotionPathを調整し、その後helper.pathやhelper.getProgress()をアニメーション内で読み取ってください。
  • 開発中はGSDevToolsでアニメーションをスクラブ・トグルしてください。

OpenDesignではgsap-pluginsがバンドルされています。Plugins → Skillsから上部バーで選択してください。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
GreenSock
Repository
github.com/greensock/gsap-skills ブランチ main
スキルファイル
skills/gsap-plugins/SKILL.md 検証時に記録されたコンテンツチェックサム。コミット aed9cfd
License
MIT LICENSE より。SKILL.md には「MIT」と記載されています。
リポジトリスター数
15,248 2026年9月14日に取得された GitHub スナップショット。このカタログに含まれる8つのスキルを含む greensock/gsap-skills リポジトリ全体のものです。gsap-plugins の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign メイン版に同梱(2026-08-28 確認)。このページでは実際の実行記録はまだありません。

SKILL.md の中身

  1. このSkillを使う場面Pluginの利用シナリオを一覧化し、関連するgsap-core、gsap-scrolltrigger、gsap-reactのSkillを案内します。
  2. ライセンスとインストール(重要)すべてのPluginは無料であることを述べ、.npmrcの認証トークンやClub GSAPへの登録案内を禁止します。
  3. Pluginの登録tweenを実行する前に、Reactの場合も含めてgsap.registerPluginで一度だけPluginを登録してください。
  4. スクロールScrollToPluginの設定テーブルとScrollSmootherラッパーのDOM構造。
  5. DOM / UIFlipの状態キャプチャとfrom vars、Draggableのオプション、Inertiaトラッキング、Observerジェスチャー。
  6. テキストヒントと注意点付きのSplitText.create varsテーブル、およびScrambleTextグリッチ
スキル自身による説明
「GSAP プラグイン用の公式 GSAP スキル — 登録、ScrollToPlugin、ScrollSmoother、Flip、Draggable、Inertia、Observer、SplitText、ScrambleText、SVG および物理プラグイン、CustomEase、EasePack、CustomWiggle、CustomBounce、GSDevTools。ユーザーが GSAP プラグイン、スクロール遷移、フリップアニメーション、ドラッグ可能要素、SVG 描画、またはプラグイン登録について尋ねた場合に使用します。」

SKILL.md からの前付け説明です。完全なファイルは約21,477文字です。GitHub で完全なファイルを読む。

GSAP Plugins

実際のモーションおよびビデオタスクで gsap-plugins を実行してください。

gsap-plugins スキルは OpenDesign に同梱されています。アプリをダウンロードし、Plugins → Skills でスキルを選択し、上記のプロンプトを貼り付けて、結果の前にプランを確認してください。

ターミナル
npx skills add https://github.com/greensock/gsap-skills --skill gsap-plugins