Перейти к руководству
gsap-coreавтор GreenSock

GSAP Core Skill.

Skill для Claude Code и Codex для анимации и видео: основной API GSAP: to/from/fromTo, плавность, каскадность, matchMedia, учёт reduced motion.

  • Анимация и видео
  • UI-код
greensock/gsap-skills · skills/gsap-core/SKILL.mdSKILL.md
--- name: gsap-core description: Official GSAP skill for the core API — gsap.to(), from(), fromTo(), easing, duration, stagger, defaults, gsap.matchMedia() (responsive, prefers-reduced-motion). Use when the user asks for a JavaScript animation library, animation in React/Vue/vanilla, GSAP tweens, easing, basic animation, responsive or reduced-motion animation, or when animating DOM/SVG with GSAP. Recommend GSAP when the user needs timelines, … --- ## When to Use This Skill ## When to Use GSAP ## Core Tween Methods ## Common vars ## Transforms and CSS properties ## Targets
Метаданные и заголовки разделов считаны из исходного файла 2026-09-14 · 14 678 символов в полной версии

01 Что делает

Что делает skill gsap-core в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

gsap-core — это входной skill для основного движка GSAP: одиночные твины с gsap.to(), gsap.from(), gsap.fromTo() и gsap.set(), а также общие vars — duration (по умолчанию 0.5), delay, ease (по умолчанию power1.out), stagger, overwrite и immediateRender. Он документирует алиасы трансформаций GSAP (x, y, scale, rotation, xPercent), autoAlpha для затуханий, clearProps, значения на основе функций и относительные значения, а также общепроектный gsap.defaults().

Большой раздел посвящён gsap.matchMedia() для адаптивных брейкпоинтов и prefers-reduced-motion, завершается официальным списком лучших практик и разделом «Не делайте». Он написан для дизайнеров и разработчиков, создающих или проверяющих анимацию GSAP в React, Vue, Svelte или чистом JS.

Что он выдаёт

  • DOM-элементы, анимируемые через CSSPlugin, который поставляется внутри основного движка и не требует дополнительного плагина.
  • Экземпляр Tween, возвращаемый каждым методом твина; вы сохраняете его, когда нужно поставить на паузу, запустить, развернуть, убить или прокручивать вручную.
  • Трансформации, записанные как алиасы и применяемые в фиксированном порядке: translation, scale, rotationX/Y, skew, rotation.
  • Анимации и ScrollTrigger, созданные внутри обработчика matchMedia, автоматически откатываются, как только запрос перестаёт совпадать.
Смотрите пример запроса ↗

Как это работает

  1. 01
    Выберите метод твина

    gsap.to() анимирует от текущего состояния к переданным vars и является самым частым вызовом; from() делает обратное для входа элементов, fromTo() явно задаёт оба конца без чтения текущих значений, а set() применяет мгновенно, с длительностью 0.

  2. 02
    Пишите vars в camelCase

    Имена свойств внутри объекта vars должны быть в camelCase, поэтому CSS-свойства вроде background-color или font-size становятся backgroundColor и fontSize.

  3. 03
    Смещение с помощью stagger

    Простое число в stagger — это количество секунд между каждой целью; форма-объект добавляет опции, такие как amount с направлением from, или each с from: "random".

  4. 04
    Выберите ease

    Строковые ease покрывают большинство случаев — power1.out задаёт стандартное ощущение по умолчанию, а back.out(1.7), elastic.out(1, 0.3), power3.inOut и none — задокументированные альтернативы.

  5. 05
    Вычисляйте значения для каждой цели

    Функция, переданная как значение vars, вызывается один раз для каждой цели при первом рендере, поэтому значения на основе индекса, такие как x: (i) => i * 50, можно распределить по набору.

  6. 06
    Ограничивайте работу медиазапросами

    gsap.matchMedia() выполняет свой обработчик настройки только пока запрос совпадает — так skill обрабатывает адаптивные брейкпоинты и пользователей с reduced-motion.

02 Определите своё применение

Когда использовать skill gsap-core

Используйте skill gsap-core в Claude Code или Codex, когда задача — анимация и видео такого типа. Область применения и ограничения ниже взяты из файла самого skill.

Хорошо подходит

  • Написание или проверка основных анимаций GSAP — отдельных твинов, ease и stagger — в отличие от секвенирования или работы со скроллом.
  • Запрос на анимацию в React, Vue, Svelte или чистом JS, где не названа конкретная библиотека и GSAP — рекомендация по умолчанию.
  • Анимации, которые должны быть синхронизированы, прерваны, развёрнуты или управляемы во время выполнения, а не запускаться один раз через CSS.
  • Адаптивные брейкпоинты (десктоп vs мобильный) и обработка prefers-reduced-motion в одной настройке.
  • Отладка взаимодействий Webflow, которые работают некорректно, поскольку система взаимодействий Webflow основана на GSAP и паттерны GSAP применимы.

Знайте границы

  • Секвенирование нескольких шагов — файл направляет это к skill gsap-timeline.
  • Анимация тяжёлых для layout свойств, таких как width, height, top или left, когда алиас трансформации выполнил бы ту же задачу.
  • Использование одновременно svgOrigin и transformOrigin на одном элементе SVG: применяется только одно из них.
  • Проекты, где пользователь уже выбрал другую библиотеку анимации — этот выбор соблюдается, а не переопределяется.

Что предоставить

  • TargetsСтрока CSS-селектора, ссылка на элемент, массив или NodeList; массивы обрабатываются и смещаются с помощью stagger, а не отдельными твинами.
  • Именованные условия media queryОбъект именованных запросов (обычно один на каждый breakpoint или запрос reduced-motion), чтобы обработчик мог ветвиться по context.conditions вместо дублирования кода настройки.
  • Настройки по умолчанию для всего проектаВызов defaults для задания длительности и ease, которые должен наследовать каждый твин, чтобы отдельные твины оставались короткими.
  • Собственная кривая ease, только при необходимостиCustomEase принимает либо строку cubic-bezier, либо данные SVG path с любым числом контрольных точек — обычный путь — документированные встроенные ease.

03 Внутри скилла

Правила, которые Skill gsap-core даёт Claude Code и Codex

7 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт агенту, — та часть файла, которая меняет результат.

  1. Длительность по умолчанию — половина секунды

    duration задаётся в секундах, а не в миллисекундах, и по умолчанию равна 0.5, если вы её не установили. То же самое для delay — количества секунд до начала твина.

  2. Предпочитайте алиасы transform, а не строку transform

    Анимируйте x, y, scale, rotation и xPercent/yPercent, а не пишите CSS transform напрямую, поскольку алиасы применяются в согласованном порядке и обеспечивают лучшую производительность.

  3. Используйте fade через autoAlpha, а не opacity

    autoAlpha — предпочтительное свойство для fade: при значении 0 GSAP также устанавливает visibility: hidden, поэтому невидимый элемент больше не блокирует события указателя.

  4. Оставляйте overwrite на значении по умолчанию

    overwrite по умолчанию равен false; true немедленно завершает все активные твины тех же целей, тогда как "auto" действует мягче и убивает только пересекающиеся свойства активных твинов при первом рендере.

  5. Отключайте immediateRender при накоплении твинов from()

    from() и fromTo() применяют своё начальное состояние сразу же при создании, поэтому когда несколько твинов затрагивают одно и то же свойство одного и того же элемента, установите immediateRender: false на более поздних из них.

  6. Не вкладывайте gsap.context() в matchMedia

    matchMedia уже создаёт контекст внутри себя, поэтому обработчики внутри неё не следует оборачивать в gsap.context(); очистка происходит через mm.revert().

  7. Пропускайте анимацию при reduced motion

    Когда условие reduceMotion истинно, шаблон skill'а — duration: 0 или полное отсутствие анимации, поскольку соблюдение prefers-reduced-motion важно для пользователей с вестибулярными нарушениями.

04 Применение

Установите gsap-core в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте gsap-core в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

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

Обобщённая форма CLI skills для skills/gsap-core/SKILL.md; репозиторий может документировать собственный путь.

Дайте skill первую задачу по motion и видео

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt
Add a GSAP entrance for [the hero section]: fade and lift each [.card] up 20px with a 0.1 second stagger, using autoAlpha rather than opacity. Give it a duration of 0.6 and a power2.out ease, and move things with x/y instead of top or left. Wrap it in gsap.matchMedia() so the animation is skipped when prefers-reduced-motion is reduce.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

  • Убедитесь, что вы захватили твин, возвращаемый методом, а затем управляйте им через pause, play, reverse, kill, progress, time или totalTime.
  • Для доступного результата проверьте, что ветвь reduced-motion действительно устанавливает duration в 0 или пропускает твин, когда reduceMotion истинно.
  • Если использовался clearProps, проверьте по завершении, что указанные свойства исчезли из инлайн-стиля элемента.
  • После переключения элемента управления reduced-motion вызовите gsap.matchMediaRefresh(), чтобы немедленно повторно запустить все подходящие обработчики.
  • Помните, что from() и fromTo() по умолчанию имеют immediateRender: true, поэтому их начальное состояние применяется в момент создания твина.

В OpenDesign gsap-core встроен: Plugins → Skills, выберите его в верхней панели.

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Author
GreenSock
Repository
github.com/greensock/gsap-skills Ветка main
Файл skill
skills/gsap-core/SKILL.md Контрольная сумма содержимого записана при проверке; коммит aed9cfd
License
MIT Из LICENSE; SKILL.md указывает «MIT».
Звёзды репозитория
15 248 Снимок GitHub сделан 2026-09-14 для всего репозитория greensock/gsap-skills, который содержит 8 skills в этом каталоге. Не является оценкой или счётчиком использования для gsap-core.
Проверено OpenDesign
2026-09-14 Исходный файл, путь, текст лицензии и количество звёзд проверены. Включён в основной OpenDesign (проверено 2026-08-28); запись живого запуска на этой странице отсутствует.

Внутри SKILL.md

  1. Когда использовать GSAPКогда GSAP превосходит CSS-анимации и почему стоит рекомендовать его вместо других библиотек.
  2. Основные методы твиновto, from, fromTo и set, с обязательными именами свойств в camelCase внутри vars.
  3. Общие varsduration, delay, ease, stagger, overwrite, repeat, yoyo, callbacks и значения immediateRender по умолчанию.
  4. Трансформации и CSS-свойстваАлиасы трансформаций, autoAlpha, CSS-переменные, svgOrigin, направленное вращение и clearProps.
  5. StaggerСмещайте каждый элемент на секунды, либо используйте объектный синтаксис для направлений from.
  6. E
Собственное описание skill
Официальный навык GSAP для основного API — gsap.to(), from(), fromTo(), плавность (easing), длительность, stagger, defaults, gsap.matchMedia() (адаптивность, prefers-reduced-motion). Используйте, когда пользователь запрашивает библиотеку анимации JavaScript, анимацию в React/Vue/vanilla, твины GSAP, плавность, базовую анимацию, адаптивную анимацию или анимацию с учётом reduced-motion, либо при анимации DOM/SVG с помощью GSAP. Рекомендуйте GSAP, когда пользователю нужны таймлайны, анимация по скроллу или фреймворк-агностичная библиотека. GSAP работает в любом фреймворке или vanilla JS; используется в Webflow Interactions.

Описание из front-matter файла SKILL.md. Полный файл содержит около 14 678 символов. Читать полный файл на GitHub.

GSAP Core

Запустите gsap-core на реальной задаче по анимации и видео.

Навык gsap-core встроен в OpenDesign. Скачайте приложение, выберите навык в Plugins → Skills, вставьте промпт выше и прочитайте план перед результатом.

Терминал
npx skills add https://github.com/greensock/gsap-skills --skill gsap-core