Skip to content

JPeetz/agent-skills / skills/frontend/web-motion-and-animation

web-motion-and-animation

Verified

Use this skill when animating: CSS, GSAP, ScrollTrigger

FileKindSize
CHANGELOG.mdmarkdown2.6 KB
LICENSEother1.1 KB
SKILL.mdskill md18.7 KB
evals/evals.jsonconfig8.6 KB
references/sources.mdmarkdown3.6 KB

references/sources.md

View on GitHub
# Sources and Further Reading

Primary material behind this skill. Both are MIT-licensed and maintained by
GreenSock (a Webflow company).

## Official AI skills (source of the decision rules)

- **greensock/gsap-skills** — <https://github.com/greensock/gsap-skills>
  Official agent skills for GSAP: core API, timelines, ScrollTrigger, plugins,
  framework integration, performance. This skill's structure follows theirs;
  the anti-slop checklist and the CSS-vs-GSAP decision table are this repo's
  additions. License: MIT. Risk level stated by the project: LOW.
- Plugin bundles in that repo: `.claude-plugin/`, `.cursor-plugin/`,
  plus `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` for agent-specific loading.

## Core documentation

- GSAP docs home — <https://gsap.com/docs/v3/>
- `gsap.to()` / `from()` / `fromTo()` —
  <https://gsap.com/docs/v3/GSAP/gsap.to()>, `/gsap.from()`, `/gsap.fromTo()`
- Timelines — <https://gsap.com/docs/v3/GSAP/Timeline/>
  (position parameter details: <https://gsap.com/docs/v3/GSAP/Timeline/#positioning-animation-in-a-timeline>)
- Easing visualiser — <https://gsap.com/docs/v3/Eases/>
- `gsap.matchMedia()` — <https://gsap.com/docs/v3/GSAP/gsap.matchMedia()/>
- `gsap.context()` — <https://gsap.com/docs/v3/GSAP/gsap.context()/>
- `gsap.quickTo()` — <https://gsap.com/docs/v3/GSAP/gsap.quickTo()/>
- `gsap.defaults()` / config — <https://gsap.com/docs/v3/GSAP/gsap.defaults()/>
- Utility methods (`toArray`, `getProperty`, `pipe`) —
  <https://gsap.com/docs/v3/GSAP/UtilityMethods/>

## ScrollTrigger

- Main page — <https://gsap.com/docs/v3/Plugins/ScrollTrigger/>
- **Common mistakes** (the highest-value page for review) —
  <https://gsap.com/resources/st-mistakes>
  Covers nested ScrollTriggers, pinning in transformed ancestors, implicit ends,
  and refresh behaviour.
- `ScrollTrigger.refresh()` —
  <https://gsap.com/docs/v3/Plugins/ScrollTrigger/static.refresh()/>
- `ScrollTrigger.normalizeScroll()` /
  `ScrollTrigger.config()` — for mobile address-bar resize handling
  (`ignoreMobileResize`).

## Framework integration

- React + `useGSAP` — <https://gsap.com/resources/React/>
- `@gsap/react` package — <https://www.npmjs.com/package/@gsap/react>
- Vue and Svelte guidance live in the same React/GSAP resource section
  (`gsap.context()` is the shared primitive).

## Accessibility

- WCAG 2.3.1 Three Flashes or Below Threshold —
  <https://www.w3.org/WAI/WCAG22/Understanding/three-flashes-or-below-threshold.html>
- WCAG 2.3.3 Animation from Interactions —
  <https://www.w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html>
- `prefers-reduced-motion` — <https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion>
- Vestibular disorder guidance (A List Apart, "Designing Safer Web Animation
  For Motion Sensitivity") —
  <https://alistapart.com/article/designing-safer-web-animation-for-motion-sensitivity/>

## Performance

- Rendering performance / compositor-friendly properties —
  <https://web.dev/articles/rendering-performance>
- `will-change` (and why not to overuse it) —
  <https://developer.mozilla.org/en-US/docs/Web/CSS/will-change>
- Layout thrashing / forced synchronous layout —
  <https://web.dev/articles/avoid-large-complex-layouts-and-layout-thrashing>
- Interaction to Next Paint —
  <https://web.dev/articles/inp>

## Related skills in this repo

- `frontend-ui-engineering` — component structure the animation attaches to.
- `design-to-code` — design intent, tokens, motion as part of the system.
- `ui-verification` — proving the animation renders and does not shift layout.
- `accessibility-compliance-audit` — reduced-motion and flash thresholds as
  auditable rules.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall