跳转到使用指南
gsap-plugins作者 GreenSock

GSAP Plugins Skill.

Claude Code 和 Codex 的动效与视频 skill:gSAP 插件:ScrollTo、ScrollSmoother、Flip、Draggable、SplitText、SVG 和物理效果。

  • Motion & Video
  • 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-09-14 的上游文件 · 完整内容 21,477 字符

01 功能说明

gsap-plugins Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

官方 GSAP skill,涵盖插件注册以及除 ScrollTrigger 之外的每个插件:ScrollTo、ScrollSmoother、Flip、Draggable、Inertia、Observer、SplitText、ScrambleText、DrawSVG、MorphSVG、MotionPath、CustomEase、EasePack、CustomWiggle、CustomBounce、Physics2D、PhysicsProps、PixiPlugin 和 GSDevTools。

内容先讲授权问题——每个插件都是免费的,不需要 Club GSAP 会员或 auth token——然后给出各插件的具体配置:Flip.from vars、Draggable options、SplitText.create vars、morphSVG options、motionPath alignment。面向从公开的 gsap npm 包安装所有内容、需要正确调用顺序、默认值和注意事项的设计师与开发者。相关 skill:gsap-core、gsap-scrolltrigger、gsap-react。

它产出什么

  • 一种将窗口或任意可滚动元素动画滚动到某个位置或目标的 scroll tween。
  • 一个 SplitText 实例,暴露 chars、words、lines,以及设置 mask 时的 masks。
  • 一个转换后的 path 元素,替换 DOM 中原有的 circle、rect、ellipse 或 line。
查看示例提示词 ↗

工作方式

  1. 01
    提前一次性注册插件

    每个插件只需注册一次,让 GSAP 和打包工具知道要引入它,且必须在任何 tween 或 API 调用使用它之前完成。

  2. 02
    用 Flip 捕获状态、改变、然后动画过渡

    Flip 是一个三步流程:读取旧状态、变更 DOM,然后从记录的状态动画过渡到新状态。

  3. 03
    创建拖拽与抛掷交互

    Draggable.create 接受 type、可选的 bounds 和 inertia;InertiaPlugin 在释放后提供动量。

  4. 04
    将文本拆分为可动画的单元

    SplitText 将字符、单词和/或行分别放入各自的元素中,从而可以按单元进行 stagger 或动画处理。

  5. 05
    绘制或变形 SVG

    SVG 相关插件通过动画 stroke dash 值实现描边动画效果,或通过动画 path 的 d 属性实现形状变形。

  6. 06
    使用缓动与物理插件

    缓动插件添加自定义曲线或具名 ease;物理插件则根据速度、角度和重力值驱动运动。

02 找到适合场景

何时使用 gsap-plugins Skill

在 Claude Code 或 Codex 中处理此类动效和视频任务时使用 gsap-plugins skill。下方的适用范围和限制摘自 skill 自身文件。

适合场景

  • 在未涉及 ScrollTrigger 的情况下滚动到某个元素或某个像素位置。
  • 在两种布局状态之间做动画,例如重新排序的列表、网格,或展开与折叠的面板。
  • 需要在鼠标和触摸上实现拖拽、旋转或抛掷行为的滑块、卡片和可重排列表。
  • 按字符、按单词或按行做动画的文字揭示。
  • 图标到图标的形变、形状过渡以及其他基于路径的 SVG 动画。

了解边界

  • SplitText 无法拆分 SVG text 元素。
  • DrawSVG 只对 stroke 做动画,从不处理 fill,也无法在视觉上改变 use 元素的内容。
  • ScrollTrigger 相关的工作应归入另一个 skill,而不是这一个。
  • 使用 text-wrap: balance 的文字与拆分配合起来效果不佳。

需要提供的信息

  • 要注册的插件清单项目中用到的每个插件都必须在一次 gsap.registerPlugin 调用中列出,这样打包工具才会将其纳入。
  • ScrollSmoother 的 DOM 结构ScrollSmoother 需要 ScrollTrigger,以及位于 smooth wrapper 内部的一层 content wrapper,而固定定位的元素可以放在其外部。
  • 为 SplitText 指定目标SplitText.create 与 split vars 一同接受选择器、元素或数组作为其目标。
  • 为 MorphSVG 提供形状必填的 shape 属性接受选择器、元素或原始路径字符串作为形变目标。
  • 字体与布局已加载完毕对于自定义字体,请在字体加载完成后再拆分,或依赖 autoSplit 配合 onSplit,以便在恰当的时机重新拆分。

03 Skill 内部

gsap-plugins Skill 向 Claude Code 和 Codex 提供的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 先注册,再做动画

    插件必须在用于任何 tween 或 API 调用之前完成注册——注册是第一步,而不是失败后的补救。

  2. 从公开的 gsap 包安装

    所有内容都随 npm install gsap 一同提供,并以 gsap/SplitText、gsap/MorphSVGPlugin 等形式导入。

  3. 绝不要生成带 auth-token 的 .npmrc

    不要创建含 GreenSock auth token 的 .npmrc,不要指向私有的 npm.greensock.com registry,也不要让用户为了某个插件去加入 Club GSAP。

  4. 在 React 的顶层注册

    在应用中只注册一次,例如在首次调用 useGSAP 之前——绝不要在会重新渲染的组件内部注册,且 useGSAP 本身也必须在使用前注册。

  5. 只拆分你要做动画的内容

    按性能需要选择拆分粒度,例如不使用 lines 时拆分 words 和 chars;仅拆分 chars 需要配合 smartWrap,以避免奇怪的换行。

  6. 在 onSplit 内构建 autoSplit 动画

    当 autoSplit 为 true 时,动画必须在 onSplit 内创建,以指向新拆分出的元素,并从 onSplit 返回,这样 SplitText 才能还原它们并做时间同步。

  7. 给 DrawSVG 一个可绘制的内容

    元素需要通过 CSS 或 SVG 属性设置 stroke 和 stroke-width,以获得可见描边,否则不会绘制任何内容。

  8. 别让仅用于开发的插件进入生产环境

    GSDevTools 只用于开发期间的调试,不应随产品发布;其他仅用于开发的插件同理。

04 投入使用

在 Claude Code 或 Codex 中安装 gsap-plugins

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 gsap-plugins 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

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

适用于 skills/gsap-plugins/SKILL.md 的通用 skills CLI 形式;仓库可能记录了它自己的路径。

给 Skill 一个首次动效和视频任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

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 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 组件卸载或元素被移除时,还原插件实例,例如 SplitTextInstance.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
Skill 文件
skills/gsap-plugins/SKILL.md 验证时记录的内容校验和;commit aed9cfd
License
MIT 来自 LICENSE;SKILL.md 注明「MIT」。
仓库星标数
15,248 GitHub 快照摄于 2026-09-14,针对整个 greensock/gsap-skills 仓库,该仓库在此目录中包含 8 个 skill。这不是 gsap-plugins 的评分或使用量统计。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可证文本和星标数。已捆绑在 OpenDesign 主版本中(检查于 2026-08-28);此页面尚未记录实际运行。

SKILL.md 内部

  1. 何时使用这个 skill列出插件适用场景,并指向相关的 gsap-core、gsap-scrolltrigger 和 gsap-react skill。
  2. 许可与安装(重要)说明所有插件均免费,并禁止提供 .npmrc 认证 token 或 Club GSAP 注册建议。
  3. 注册插件在任何 tween 之前用 gsap.registerPlugin 注册一次插件,React 中也是如此。
  4. 滚动ScrollToPlugin 配置表,以及 ScrollSmoother 包装层的 DOM 结构。
  5. DOM / UIFlip 状态捕获与 from vars、Draggable 选项、Inertia 跟踪、Observer 手势。
  6. 文本SplitText.create vars 表及使用提示与注意事项,外加 ScrambleText 故障效果
Skill 自身的描述
"GSAP 插件官方 GSAP skill — 注册、ScrollToPlugin、ScrollSmoother、Flip、Draggable、Inertia、Observer、SplitText、ScrambleText、SVG 和物理插件、CustomEase、EasePack、CustomWiggle、CustomBounce、GSDevTools。当用户询问 GSAP 插件、滚动到、flip 动画、可拖动、SVG 绘制或插件注册时使用。"

来自 SKILL.md 的 front-matter 描述。完整文件约 21,477 个字符。在 GitHub 上阅读完整文件。

GSAP Plugins

在真实动效和视频任务上运行 gsap-plugins。

gsap-plugins skill 内置于 OpenDesign。下载应用,在 Plugins → Skills 中选择该 skill,粘贴上方提示词,在查看结果前先阅读计划。

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