К основному содержанию
скилл CX Codex

Скилл lottie для Claude Code: Lottie и dotLottie в HyperFrames · boraoztunc

Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр.

Apache-2.0 212 установок ★ 484 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add boraoztunc/skills --skill lottie -a claude-code
Открыть на GitHub

Что делает lottie

Скилл разбирает два плеера, которые HyperFrames умеет перематывать: lottie-web и @lottiefiles/dotlottie-web. Таймлайн уже лежит внутри файла анимации, поэтому адаптеру нужен только объект плеера. Для lottie-web это вызов goToAndStop(timeMs, false), для dotLottie — методы кадров или процентов, смотря какой плеер собрался.

Внутри готовые HTML-заготовки под оба варианта и короткий набор правил. Файлы берутся локально, обычно из assets/. Автоплей выключен, цикл тоже, если пользователь не просил обратного. Размеры контейнера фиксируются через CSS, чтобы ничего не прыгало. Каждый экземпляр кладётся в массив window.__hfLottie — HyperFrames ищет плееры именно там, и незарегистрированная анимация останется стоять на месте.

После правок композиции скилл велит прогнать npx hyperframes lint, затем npx hyperframes validate. Запускать через play() не надо, как и тянуть удалённые path-URL во время рендера. Асинхронная загрузка плеера после того, как валидация уже осмотрела страницу, тоже ломает проверку. Эффекты After Effects, которые не пережили экспорт, придётся проверять в браузере самому.

Какие задачи решает

  • встроить экспорт из After Effects в HTML-композицию HyperFrames
  • перемотать Lottie-анимацию на нужный момент таймлайна
  • запустить несколько анимаций от общего времени композиции
  • переписать Lottie-компонент из Remotion на обычный HTML
  • поймать сломанную композицию линтером и валидатором

Примеры запросов агенту

  • Вставь assets/logo-reveal.json через lottie-web и зарегистрируй анимацию в window.__hfLottie.
  • Переведи этот Lottie-компонент из Remotion в чистый HTML для HyperFrames, без автоплея.
  • Добавь два плеера dotLottie и перемотай оба на середину композиции, потом прогони npx hyperframes validate.

Как установить lottie

1Через Skills CLI (Vercel)

npx skills add boraoztunc/skills --skill lottie -a claude-code

2Вручную: положить файлы

~/.claude/skills/lottie/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/lottie/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о lottie

Как установить скилл lottie в Claude Code?

Выполните npx skills add boraoztunc/skills --skill lottie -a claude-code. Файл скилла появится по пути ~/.claude/skills/lottie/SKILL.md.

Что делает скилл lottie?

Показывает агенту, как подключить lottie-web или dotLottie в HyperFrames, зарегистрировать плеер в window.__hfLottie и не сломать перемотку таймлайна.

Почему анимация не перематывается?

Скорее всего плеер не попал в window.__hfLottie или запускался через play(). HyperFrames двигает только те экземпляры, которые нашёл в этом массиве.

Исходный текст

SKILL.md · Apache-2.0
---
name: lottie
description: Lottie and dotLottie adapter patterns for HyperFrames. Use when embedding lottie-web JSON animations, .lottie files, @lottiefiles/dotlottie-web players, registering instances on window.__hfLottie, or making After Effects exports deterministic in HyperFrames.
---

# Lottie for HyperFrames

HyperFrames can seek both `lottie-web` and dotLottie players through its `lottie` runtime adapter. Lottie is a strong fit because the animation timeline is already encoded in the asset; HyperFrames only needs a player object it can seek.

## Contract

- Load assets from local project files, usually under `assets/`.
- Set `autoplay: false`.
- Prefer `loop: false` unless the user explicitly wants a loop.
- Register every returned animation or player on `window.__hfLottie`.
- Keep the Lottie container dimensions stable with CSS.

The adapter seeks `lottie-web` with `goToAndStop(timeMs, false)` and dotLottie with frame or percentage APIs depending on player shape.

## lottie-web Pattern

```html
<div id="logo-lottie" class="lottie-layer"></div>
<script src="https://cdnjs.cloudflare.com/ajax/libs/bodymovin/5.12.2/lottie.min.js"></script>
<script>
  const anim = lottie.loadAnimation({
    container: document.getElementById("logo-lottie"),
    renderer: "svg",
    loop: false,
    autoplay: false,
    path: "assets/logo-reveal.json",
  });

  window.__hfLottie = window.__hfLottie || [];
  window.__hfLottie.push(anim);
</script>
```

```css
.lottie-layer {
  width: 100%;
  height: 100%;
}
```

## dotLottie Pattern

```html
<canvas id="product-lottie" class="lottie-canvas"></canvas>
<script src="https://unpkg.com/@lottiefiles/dotlottie-web"></script>
<script>
  const player = new DotLottie({
    canvas: document.getElementById("product-lottie"),
    src: "assets/product-flow.lottie",
    autoplay: false,
    loop: false,
  });

  window.__hfLottie = window.__hfLottie || [];
  window.__hfLottie.push(player);
</script>
```

```css
.lottie-canvas {
  width: 100%;
  height: 100%;
  display: block;
}
```

## Multiple Animations

Push each player into the same registry:

```js
window.__hfLottie = window.__hfLottie || [];
window.__hfLottie.push(backgroundAnim);
window.__hfLottie.push(iconAnim);
window.__hfLottie.push(confettiAnim);
```

HyperFrames seeks them all to the same composition time.

## Good Uses

- After Effects exports that are already known to render correctly in lottie-web.
- Logo reveals, icon loops, decorative accents, and product UI motion.
- Translating Remotion Lottie usage into plain HyperFrames HTML.

## Avoid

- Relying on remote `path` URLs at render time.
- Starting playback with `play()`.
- Assuming unsupported After Effects effects will survive export. Test the JSON or `.lottie` file in a browser first.
- Loading a player asynchronously and registering it after HyperFrames validation has already inspected the page.

## Validation

After editing a Lottie composition:

```bash
npx hyperframes lint
npx hyperframes validate
```

## Credits And References

- HyperFrames adapter source: `packages/core/src/runtime/adapters/lottie.ts`.
- lottie-web by Airbnb: https://github.com/airbnb/lottie-web
- lottie-web `loadAnimation` options: https://github.com/airbnb/lottie-web/wiki/loadAnimation-options
- dotLottie web player methods by LottieFiles: https://developers.lottiefiles.com/docs/dotlottie-player/dotlottie-web/methods

© boraoztunc · Apache-2.0 · boraoztunc/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — lottie от других авторов.

lottie Mindrally Правила для ИИ-агента, который пишет Lottie-анимации на веб-страницах: формат dotLottie, ленивая загрузка, выбор рендерера и доступность. CX Codex +1 1 200установок lottie-animation iart-ai Скилл lottie-animation помогает агенту подключить анимацию из After Effects, управлять воспроизведением и перекрашивать её во время работы приложения. CX Codex +1 3 800установок lottie-animations freshtechbro Скилл lottie-animations, который помогает агенту подключать Lottie-анимации из After Effects в веб и React: выбирать библиотеку, ставить плееры и управлять воспроизведением. CX Codex +1 3 300установок lottie-bodymovin calesthio Скилл lottie-bodymovin помогает переносить 12 принципов диснеевской анимации в векторные Lottie-ролики. Связывает формулы After Effects с управлением через JavaScript. CX Codex +1 1 200установок Generative Icons LottieFiles MCP-сервер Generative Icons для Claude Code и других сред разработки. Позволяет искать готовые векторные Lottie-иконки по смыслу, подбирать анимацию и генерировать новые ассеты прямо в проекте. CX Codex +1 ★ 7звёзд репо text-to-lottie diffusionstudio Скилл text-to-lottie генерирует, редактирует и чинит анимации Lottie JSON для локального плеера Skia Skottie. Пригодится при сборке интерфейсных лоадеров, титров и графиков. CX Codex +1 11 600установок lottie-animation-delivery calesthio Скилл lottie-animation-delivery для Claude Code координирует передачу векторных анимаций Lottie и dotLottie в приложения. Он отслеживает совместимость рендеринга и требования к целевым платформам. CX Codex +1 137установок

Из того же набора22

Весь набор →
animejs Помогает встраивать анимации Anime.js в композиции HyperFrames с привязкой к общему таймлайну рендеринга. CX Codex +1 220установок hyperframes-media Скилл hyperframes-media для Claude Code готовит медиа для композиций HyperFrames: озвучивает текст, транскрибирует аудио и видео с таймстампами и удаляет фон. CX Codex +1 218установок tailwind Скилл настраивает Tailwind CSS v4.2 для HyperFrames-композиций и помогает отлаживать стили перед захватом кадров. CX Codex +1 218установок hyperframes-cli Скилл hyperframes-cli оркестрирует создание HTML-видео через npx hyperframes: от инициализации проекта до визуального аудита и сборки MP4. CX Codex +1 216установок waapi Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP. CX Codex +1 211установок contribute-catalog Скилл contribute-catalog для Claude Code и Codex ведёт создание блока или компонента HyperFrames от идеи до PR в публичный каталог. Задачи: caption styles, VFX, переходы и lower thirds. CX Codex +1 211установок three Держит Three.js-сцену в HyperFrames синхронной со временем ролика: адаптер шлёт hf-seek, а сцена рисует запрошенный кадр. CX Codex +1 209установок typegpu Скилл для создания GPU-композиций с TypeGPU и WebGPU в HyperFrames: фрагментные шейдеры WGSL, вычислительные пайплайны, стеклянные эффекты и частицы на canvas. CX Codex +1 207установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой