waapi — скилл для Claude Code: что делает и как установить
Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP.
Apache-2.0 211 установок ★ 484 обновлён 2026-08-15
npx skills add boraoztunc/skills --skill waapi -a claude-codeЧто делает waapi
Скилл даёт агенту набор правил для работы с рантайм-адаптером HyperFrames waapi. Он нужен при вызове element.animate(), ручном управлении currentTime и поиске анимаций через document.getAnimations().
Адаптер требует создавать анимации строго синхронно при инициализации композиции, указывать конечные duration и iterations, а также ставить fill: "both". Сразу после создания вызовы нужно ставить на паузу через animation.pause().
Без свойства fill: "both" кадры при перемотке не сохранят состояние. Асинхронные колбэки и промисы вроде animation.finished использовать нельзя, потому что они нарушают покадровый рендеринг. Для проверки готового кода запускаются npx hyperframes lint и npx hyperframes validate.
Какие задачи решает
- настроить нативную анимацию элементов через
element.animate()для HyperFrames - создать ступенчатое появление элементов со сдвигом по задержке
- исключить рассинхрон кадров при покадровой перемотке таймлайна
- проверить код композиции утилитами
hyperframes
Примеры запросов агенту
- Сделай ступенчатую анимацию появления для списка токенов по правилам адаптера waapi
- Напиши нативную анимацию сдвига и прозрачности для блока orb без внешних библиотек
- Проверь этот скрипт анимации на соответствие контракту HyperFrames
Как установить waapi
1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill waapi -a claude-code2Вручную: положить файлы
~/.claude/skills/waapi/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/waapi/
1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill waapi -a codex2Вручную: положить файлы
.agents/skills/waapi/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill waapi -a cursor2Вручную: положить файлы
.cursor/skills/waapi/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install boraoztunc/skills waapi2Вручную: положить файлы
.github/skills/waapi/SKILL.md1Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill waapi -a gemini-cli2Командой платформы
gemini skills install https://github.com/boraoztunc/skills --path waapiВручную: положить файлы
.devin/skills/waapi/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill waapi -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о waapi
Как установить waapi в Claude Code?
Выполните команду npx skills add boraoztunc/skills --skill waapi -a claude-code. Также можно вручную поместить файл по пути ~/.claude/skills/waapi/SKILL.md.
Что делает скилл waapi?
Он объясняет агенту правила Web Animations API, при которых таймлайн HyperFrames может детерминированно управлять кадрами через currentTime.
Зачем указывать fill: "both" в анимациях?
Адаптер HyperFrames перемещает время напрямую по миллисекундам. Без fill: "both" свойства элементов сбрасываются до и после интервала анимации при перемотке.
Исходный текст
SKILL.md · Apache-2.0
---
name: waapi
description: Web Animations API adapter patterns for HyperFrames. Use when authoring element.animate() motion, Animation currentTime seeking, document.getAnimations(), KeyframeEffect timing, fill modes, or native browser animations that must render deterministically in HyperFrames.
---
# Web Animations API for HyperFrames
HyperFrames can seek Web Animations API animations through its `waapi` runtime adapter. WAAPI is useful when you want native browser keyframes with JavaScript-created timing and no GSAP dependency.
## Contract
- Create animations synchronously during composition initialization.
- Use `element.animate(...)` with finite `duration` and `iterations`.
- Use `fill: "both"` so seeked states persist.
- Pause animations after creation or let the adapter pause them on first seek.
- Avoid callbacks and promises for render-critical state.
The adapter calls `document.getAnimations()`, sets each animation's `currentTime` to HyperFrames time in milliseconds, then pauses it.
## Basic Pattern
```html
<div id="orb" class="clip orb" data-start="2" data-duration="3" data-track-index="2"></div>
<script>
const orb = document.getElementById("orb");
const animation = orb.animate(
[
{ transform: "translate3d(-160px, 0, 0) scale(0.8)", opacity: 0 },
{ transform: "translate3d(0, 0, 0) scale(1)", opacity: 1, offset: 0.35 },
{ transform: "translate3d(120px, 0, 0) scale(1.08)", opacity: 1 },
],
{
duration: 3000,
delay: 2000,
easing: "cubic-bezier(0.2, 0, 0, 1)",
fill: "both",
iterations: 1,
},
);
animation.pause();
</script>
```
## Stagger Pattern
```js
document.querySelectorAll(".token").forEach((token, index) => {
const animation = token.animate(
[
{ transform: "translateY(24px)", opacity: 0 },
{ transform: "translateY(0)", opacity: 1 },
],
{
duration: 620,
delay: index * 80,
easing: "cubic-bezier(0.2, 0, 0, 1)",
fill: "both",
iterations: 1,
},
);
animation.pause();
});
```
## Good Uses
- Lightweight DOM motion where CSS keyframes are too rigid and GSAP is unnecessary.
- Generated animations from structured data.
- Simple timelines that can be represented as keyframes, delays, and offsets.
## Avoid
- Infinite `iterations`.
- Depending on `animation.finished` to mutate render-critical DOM.
- Running separate clocks with `requestAnimationFrame`, timers, or `performance.now()`.
- Animating layout properties when transforms and opacity can express the motion.
- Assuming clip-local start time is automatic. WAAPI adapter seeks document-level animation time; model clip offsets with `delay` or create the animation on an element whose visibility is controlled by HyperFrames timing.
## Validation
After editing a WAAPI composition:
```bash
npx hyperframes lint
npx hyperframes validate
```
## Credits And References
- HyperFrames adapter source: `packages/core/src/runtime/adapters/waapi.ts`.
- MDN Web Animations API guide: https://developer.mozilla.org/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API
- MDN `Animation.currentTime`: https://developer.mozilla.org/en-US/docs/Web/API/Animation/currentTime
© boraoztunc · Apache-2.0 · boraoztunc/skills