Скилл lottie для Claude Code: Lottie и dotLottie в HyperFrames · boraoztunc
Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр.
Apache-2.0 212 установок ★ 484 обновлён 2026-08-15
npx skills add boraoztunc/skills --skill lottie -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/lottie/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/lottie/
1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill lottie -a codex2Вручную: положить файлы
.agents/skills/lottie/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill lottie -a cursor2Вручную: положить файлы
.cursor/skills/lottie/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install boraoztunc/skills lottie2Вручную: положить файлы
.github/skills/lottie/SKILL.md1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill lottie -a gemini-cli2Командой платформы
gemini skills install https://github.com/boraoztunc/skills --path lottieВручную: положить файлы
.devin/skills/lottie/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill lottie -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.