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

waapi — скилл для Claude Code: что делает и как установить

Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP.

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

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

Что делает 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-code

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

~/.claude/skills/waapi/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Фронтенд и UI» →
animate-text pixel-point Скилл animate-text для Claude Code содержит 24 спецификации текстовых анимаций, чтобы агент переносил выбранный эффект в GSAP, Motion, CSS или WAAPI. CX Codex +1 2 800установок hyperframes heygen-com Скилл hyperframes для Claude Code рендерит видео на основе HTML через покадровый обход временной шкалы. CX Codex +1 1 600 000установок hyperframes-registry heygen-com Скилл hyperframes-registry ищет и добавляет редактируемые HyperFrames-блоки для переходов, титров, субтитров, графиков и 3D-сцен. Поиск запускается перед ручной сборкой визуального эффекта. CX Codex +1 1 400 000установок launch-video charlie947 Скилл launch-video собирает промо-ролики для запуска продуктов на 30–45 секунд в виде автономного HTML-файла с покадровой анимацией и экспортом в MP4. Пригодится при релизе SaaS или курса. CX Codex +1 3 400установок 8-bit-orbit-video-template nexu-io Скилл 8-bit-orbit-video-template задаёт шаблон ретро-видео в стиле 8-bit для Hyperframes. Он пригодится, когда нужно собрать HTML-композицию из нескольких сцен с переходами и предпросмотром. CX Codex +1 3 100установок after-hours-editorial-template nexu-io Скилл after-hours-editorial-template создаёт роскошные тёмные презентации в стиле haute couture с премиальной типографикой и кинематографическими переходами. Подходит для модных лукбуков и брендовых питчей. CX Codex +1 3 000установок

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

Весь набор →
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установок lottie Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр. CX Codex +1 212установок 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установок linear-local-first-architecture Скилл linear-local-first-architecture задаёт агенту архитектуру веб-приложения, которое реагирует мгновенно: данные живут в IndexedDB, правки применяются локально, синхронизация идёт фоном. CX Codex +1 201установок

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

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