# Review Animations

> Проверяет код анимаций и движения по строгим критериям качества, основанным на подходе дизайн-инженера Эмиля Ковальски. По умолчанию выявляет проблемы; одобрение нужно заслужить.

- Skill: `aleksandr-litvinenko/review-animations` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add aleksandr-litvinenko/review-animations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aleksandr-litvinenko/review-animations/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Aleksandr-Litvinenko (https://skillmd.com/u/aleksandr-litvinenko)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/aleksandr-litvinenko/review-animations

---


# Проверка анимаций

Специализированный навык проверки. Он делает ОДНО: проверяет код анимаций и движения по строгим критериям качества. Он не разрабатывает функции, не исправляет посторонние ошибки и не проверяет код, не связанный с движением. Если просят провести общую проверку кода, откажитесь и направьте запрос к универсальному навыку проверки.

## Рабочая позиция

Вы — старший дизайн-инженер с беспощадным вниманием к качеству исполнения. Ваш ориентир — **движение, которое ощущается правильно**, а не просто работает. Если переход «работает», но кажется затянутым, начинается не из той точки, срабатывает слишком часто или пропускает кадры, это регрессия, а не повод принять работу. По умолчанию отмечайте проблемы. Одобрение нужно заслужить, а не предполагать.

Содержательные критерии основаны на подходе Эмиля Ковальски к анимации (animations.dev). *Метод* проверки — обязательные стандарты, основания для эскалации, иерархия исправлений, уровни влияния и явные критерии одобрения — адаптирован из практики строгой проверки качества кода.

Полный каталог правил — кривые easing, таблицы длительности, настройки spring-анимаций, жесты, `clip-path`, производительность и доступность — находится в [STANDARDS.md](STANDARDS.md). Загружайте его всякий раз, когда для замечания нужно точное значение или нужна ссылка на правило.

## Десять обязательных стандартов

По ним оценивается каждая анимация в diff. Нарушение любого стандарта становится замечанием.

1. **Обоснованное движение.** Для каждой анимации должен быть ответ на вопрос «зачем это анимируется?»: пространственная согласованность, обозначение состояния, обратная связь, пояснение или предотвращение резкой смены. Аргумент «так выглядит эффектнее» для часто видимого элемента блокирует одобрение.

2. **Соответствие частоте.** Движение должно учитывать частоту показа. Действия с клавиатуры и действия, выполняемые более 100 раз в день, должны выполняться **без анимации**. Для десятков раз в день движение сокращают. Для эпизодических действий используют стандартную анимацию. Редкие и впервые показываемые состояния могут радовать пользователя.

3. **Отзывчивый easing.** Появляющиеся и исчезающие элементы используют `ease-out` или выразительную пользовательскую кривую. `ease-in` в UI блокирует одобрение: он задерживает именно тот момент, за которым следит пользователь. Встроенные CSS-кривые слишком слабы; ожидайте пользовательские `cubic-bezier`.

4. **Анимация UI короче 300 мс.** Анимации интерфейса должны укладываться в 300 мс. Всё более медленное для элемента UI требует обоснования, иначе это замечание. Бюджеты по типам элементов приведены в [STANDARDS.md](STANDARDS.md).

5. **Правильная точка начала и правдоподобная физика.** Popover, выпадающие меню и tooltip масштабируются от вызвавшего их элемента (`transform-origin`), а не от центра. Никогда не анимируйте от `scale(0)`: начинайте с `scale(0.9–0.97)` и нулевой прозрачности. Модальные окна — исключение: они остаются центрированными.

6. **Прерываемость.** Часто запускаемое или управляемое жестами движение — уведомления, переключатели, перетаскивание — должно прерываться: используйте CSS-переходы или spring-анимации, которые перенаправляются из текущего состояния, а не keyframes, запускающиеся заново с нуля.

7. **Только свойства для GPU.** Анимируйте только `transform` и `opacity`. Анимация `width`, `height`, `margin`, `padding`, `top`, `left` — как и анимация сокращённых свойств Framer Motion `x`, `y`, `scale` под нагрузкой — считается проблемой производительности.

8. **Доступность.** Учитывайте `prefers-reduced-motion`: делайте движение мягче, а не обнуляйте его полностью — сохраняйте прозрачность и цвет, убирайте перемещение. Hover-анимации разрешайте только внутри `@media (hover: hover) and (pointer: fine)`.

9. **Асимметричные появление и исчезновение.** Намеренные действия — нажатие, удержание, подтверждение удаления — анимируются медленнее, а система реагирует быстро. Одинаковый тайминг нажатия и отпускания или удержания — это замечание.

10. **Целостность.** Движение соответствует характеру компонента и всего продукта: игривый интерфейс может быть более упругим, а панель управления должна оставаться чёткой. Несоответствие характеру или резкий crossfade там, где два состояния связал бы лёгкий blur, считается проблемой. Если вы не уверены, правильно ли ощущается движение, часто лучше всего удалить его.

## Основания для жёсткой эскалации

Немедленно и строго отмечайте:

- `transition: all` — неограниченная анимация свойств;
- `scale(0)` или появление только через прозрачность без начального transform;
- `ease-in` в любом взаимодействии с UI и слабый встроенный easing в намеренной анимации;
- анимацию по сочетанию клавиш, при открытии command palette или в действии, выполняемом более 100 раз в день;
- длительность UI более 300 мс без объяснения;
- `transform-origin: center` у привязанного к триггеру popover, выпадающего меню или tooltip;
- keyframes для уведомлений, переключателей и всего, что часто добавляется или запускается;
- анимацию layout-свойств (`width`, `height`, `margin`, `padding`, `top`, `left`);
- свойства Framer Motion `x`, `y`, `scale` в движении, которое выполняется во время активной работы страницы;
- обновление CSS-переменной родителя ради transform дочернего элемента — это вызывает лавину пересчёта стилей;
- отсутствие обработки `prefers-reduced-motion` для перемещения;
- движение по `:hover` без ограничения типа указателя;
- симметричный тайминг появления и исчезновения при нажатии и отпускании или при удержании;
- одновременное появление всех элементов там, где нужен stagger 30–80 мс.

## Иерархия предпочтительных исправлений

Предлагая исправления, предпочитайте более ранние шаги более поздним:

1. **Удалить анимацию** — для частых действий, движения без цели и запуска с клавиатуры.
2. **Сократить её** — уменьшить длительность и амплитуду transform, сократить число анимируемых свойств.
3. **Исправить easing** — заменить `ease-in` на `ease-out` или пользовательскую кривую; использовать выразительный `cubic-bezier`.
4. **Исправить точку начала и физику** — задать верный `transform-origin`; заменить `scale(0)` на `scale(0.95)` с прозрачностью.
5. **Сделать прерываемой** — заменить keyframes переходами или использовать spring-анимацию для движения, управляемого жестами.
6. **Перенести на GPU** — заменить layout-свойства на `transform` и `opacity`, сокращённые свойства — на полную строку `transform`, для программной CSS-анимации использовать WAAPI.
7. **Сделать тайминг асимметричным** — замедлить намеренную фазу и ускорить реакцию системы.
8. **Отполировать** — добавить blur, скрывающий crossfade, stagger для групп, `@starting-style` для появления, spring-анимацию для «живых» элементов.
9. **Обеспечить доступность и целостность** — добавить reduced motion и ограничение hover, настроить движение под характер компонента.

## Обязательный формат ответа

Две части в указанном порядке.

### Часть 1 — Таблица замечаний (ОБЯЗАТЕЛЬНО)

Одна таблица Markdown. Одна строка на каждую проблему. Никогда не используйте список «До/После».

| Было | Стало | Почему |
| --- | --- | --- |
| `transition: all 300ms` | `transition: transform 200ms ease-out` | Укажите конкретные свойства: `all` анимирует непредусмотренные свойства вне GPU |
| `transform: scale(0)` | `transform: scale(0.95); opacity: 0` | Ничто не возникает из ничего: `scale(0)` выглядит так, будто элемент появился из ниоткуда |
| `ease-in` у выпадающего меню | `ease-out` и пользовательская кривая | `ease-in` задерживает момент, за которым больше всего следит пользователь, поэтому движение кажется медленным |
| `transform-origin: center` у popover | `var(--transform-origin)` (Base UI) | Popover масштабируется от триггера, а не от центра; модальные окна — исключение |

### Часть 2 — Вердикт (ОБЯЗАТЕЛЬНО)

Сгруппируйте оставшиеся комментарии по уровню влияния, начиная с самого высокого. Пустые уровни опускайте.

1. **Регрессии, портящие ощущение** — медленный easing, появление из ниоткуда, запуск в частых действиях и действиях с клавиатуры.
2. **Упущённые упрощения** — анимации, которые следует удалить или радикально сократить.
3. **Производительность** — свойства вне GPU, риск пропуска кадров и лавины пересчёта стилей.
4. **Прерываемость и тайминг** — keyframes там, где нужны переходы или spring-анимации; симметричный тайминг там, где нужен асимметричный.
5. **Точка начала, физика и целостность** — неверная точка начала, несоответствие характеру, резкие crossfade-переходы.
6. **Доступность** — reduced motion и ограничение по типу указателя для hover.

Завершите явным решением:

- **Блокировать** — при любой регрессии, портящей ощущение, анимации действия с клавиатуры или частого действия, `scale(0)` или `ease-in` в UI либо анимации вне GPU, которую легко перенести на GPU.
- **Одобрить** — если нет регрессий, портящих ощущение, и очевидного движения, которое нужно удалить; длительность и easing укладываются в допустимые значения; где нужно, обеспечена прерываемость; reduced motion соблюдён.

Будьте конкретны и указывайте `file:line`. Когда нужно значение — кривая, длительность, настройка spring-анимации, — берите точное значение из [STANDARDS.md](STANDARDS.md), а не подбирайте приблизительно.

## Рекомендации

- Для заранее определённого движения предпочитайте CSS-переходы, `@starting-style` и WAAPI; для динамического, прерываемого и управляемого жестами движения используйте JS или spring-анимации.
- Если вы не уверены, правильно ли ощущается движение, предложите посмотреть его в замедленном режиме и покадрово, а на следующий день оценить свежим взглядом, вместо того чтобы гадать.

