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

hyperframes-keyframes — скилл для Claude Code

Скилл hyperframes-keyframes держит анимацию в композиции HyperFrames перематываемой: собирает кейфреймы для GSAP, CSS, Anime.js и WAAPI и проверяет кадры до рендера.

MIT ★ 328 обновлён 2026-10-29

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

Что делает hyperframes-keyframes

Скилл разбирает анимацию HyperFrames на видимые состояния и следит, чтобы любой кадр можно было получить перемоткой. Под него попадают 2D- и 3D-кейфреймы, таймлайны GSAP, CSS-анимации, Anime.js, WAAPI, FLIP, движение по пути, маски, отрисовка и морфинг SVG.

Работа идёт по шагам: назвать движущийся объект и позы, выбрать минимальный механизм под задачу, собрать кейфреймы синхронно и зарегистрировать рантайм. Дальше проверка — hyperframes lint, hyperframes check, hyperframes keyframes, один --shot и снимки на опорных моментах. Таймлайн GSAP без регистрации в window.__timelines[compositionId] с ключом, совпадающим с data-composition-id, покадровый рендер не подхватит, поэтому проверять надо до рендера.

Для рендер-критичной анимации скилл запрещает Date.now(), performance.now(), незасеянный Math.random(), таймеры, триггеры hover и бесконечные циклы. За рецептами сцен он отправляет в hyperframes-animation, за полной документацией команд — в hyperframes-cli; бренд-дизайн, подбор медиа и субтитры остаются вне его зоны.

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

  • Сделать анимацию, которая корректно перематывается при покадровом рендере
  • Собрать таймлайн GSAP и зарегистрировать его под data-composition-id
  • Выбрать механизм под движение: FLIP, path travel, stroke draw, маска или 3D-камера
  • Проверить кадры диагностикой hyperframes keyframes и снимками на опорных моментах
  • Убрать из рендер-критичной анимации таймеры и незасеянный Math.random()

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

  • Сделай seek-safe анимацию карточки: три позы, финальный кадр держится, таймлайн зарегистрируй в window.__timelines
  • Перепиши эту CSS-анимацию на Anime.js с autoplay: false и конечным числом циклов
  • Прогони hyperframes keyframes и один --shot на опорном моменте и скажи, какой кейфрейм ломается

Как установить hyperframes-keyframes

1Через Skills CLI (Vercel)

npx skills add coco-research/coco --skill hyperframes-keyframes -a claude-code

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

~/.claude/skills/hyperframes-keyframes/SKILL.md

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

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

Вопросы о hyperframes-keyframes

Как установить hyperframes-keyframes в Claude Code?

Запустите npx skills add coco-research/coco --skill hyperframes-keyframes -a claude-code. Скилл встанет в ~/.claude/skills/hyperframes-keyframes/SKILL.md.

Что делает hyperframes-keyframes?

Собирает кейфреймы композиции HyperFrames так, чтобы их можно было перематывать, и проверяет результат диагностиками и снимками кадров.

Чем он отличается от hyperframes-animation?

Рецепты сцен и общая стратегия анимации лежат в hyperframes-animation, а этот скилл отвечает только за кейфреймы и их проверку. Полная документация команд — в hyperframes-cli.

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

SKILL.md · MIT
---
name: hyperframes-keyframes
description: >
  Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP
  timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw,
  text trails, 3D depth, or `hyperframes keyframes` diagnostics.
  Don't use for broad scene strategy, brand design, media sourcing, captions, or
  general video planning.
---

# HyperFrames Keyframes

Keyframes are a pose contract: visible states, continuous subject identity, seek-safe runtime, verified pixels.

Use `hyperframes-animation` for broad scene recipes. Use `hyperframes-cli` for full command docs. Use `references/keyframe-patterns.md` only when choosing implementation mechanisms, not visual style.

## Procedure

1. Identify the animated subject, visible states, final state, and runtime.
2. Choose the smallest mechanism that proves the prompt. Read `references/keyframe-patterns.md` only if the mechanism is unclear.
3. Author seek-safe keyframes in the declared runtime. Build synchronously and register the runtime instance.
4. Verify with `hyperframes lint`, `hyperframes check`, `hyperframes keyframes`, one focused `--shot`, and snapshots at proof times.
5. If proof fails, fix the source keyframes and rerun the smallest failing diagnostic before rendering.

## Contract

- Name the moving subject.
- Name the poses needed to prove the intended motion, including the final state.
- Keyframe visible channels, not hidden helper state.
- Preserve object identity when continuity matters.
- Crossfade only when the intended motion is replacement or dissolve.
- Hold readable or semantic states long enough to see.
- Final frame is part of the animation, not cleanup.
- Do not reset to rest unless requested.
- Do not end on black unless requested.
- If editing a starter scene, preserve layout, copy, assets, colors, and final state unless asked to redesign.

## Runtime Rules

GSAP:

- build synchronously at page load
- use `gsap.timeline({ paused: true })`
- register as `window.__timelines[compositionId]`
- registry key must match `data-composition-id`
- do not call `tl.play()` for render-critical motion
- keep repeats finite

CSS keyframes:

- finite duration and iteration count
- deterministic delay
- `animation-fill-mode: both`
- use `data-start` when timing belongs to a clip

Anime.js:

- create synchronously
- `autoplay: false`
- finite duration and loops
- push every instance to `window.__hfAnime`

WAAPI:

- finite `duration`
- `fill: "both"`
- deterministic construction
- the text surface does not list WAAPI; verify with `--shot` (it seeks WAAPI) and snapshots

Never use for render-critical motion:

- `Date.now()`
- `performance.now()`
- unseeded `Math.random()`
- hover/scroll triggers
- timers
- async-created timelines
- unregistered `requestAnimationFrame`
- infinite loops

## GSAP Skeleton

```js
const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
```

Use labels for semantic states. Use position parameters instead of chained delays. Use `immediateRender: false` for later `from()`/`fromTo()` tweens touching the same property.

## Keyframe Forms

- Array keyframes: pose ladder with per-step duration/ease.
- Percentage keyframes: exact timing inside one tween.
- Property arrays: compact multi-stop changes.
- `ease: "none"` on the parent when each stop carries its own easing.
- `easeEach` when every segment should share the same feel.

Do not copy numeric distances or timing from examples. Derive them from the actual composition geometry and duration.

For one subject moving between two boxes, prefer one continuous transform tween or FLIP. Split `x/y/scale` into multiple eased keyframes only when the viewer should feel distinct beats; every segment changes velocity and can read as a hitch.

## Channels

Prefer compositor/visual channels: `x/y/z`, `xPercent/yPercent`, `scale`, `rotationX/Y/Z`, `skew`, `transformOrigin`, `svgOrigin`, `opacity`, `autoAlpha`, `clip-path`, masks, CSS vars, SVG path/dash values, camera transforms, shader uniforms.

Avoid layout/lifecycle channels: `top/left/right/bottom`, `width/height`, `margin/padding`, `display`, `visibility`, late DOM creation, helper overlays doing subject motion.

For visibility changes, use `autoAlpha` on the registered seekable GSAP timeline, or a zero-duration `tl.set()` at an explicit boundary. Target only a non-clip element or a wrapper inside the clip; never target `.clip` itself. Never duration-tween raw `visibility`, and never tween `display`.

## Mechanism Choice

Choose the smallest mechanism that proves the prompt:

| Need                                  | Mechanism                                          |
| ------------------------------------- | -------------------------------------------------- |
| Same subject changes box or hierarchy | shared element / FLIP                              |
| Subject travels a visible route       | path travel                                        |
| Stroke grows or traces                | stroke draw                                        |
| Shape becomes another shape           | shape interpolation                                |
| Reveal boundary is visible            | clip, mask, or shader uniform                      |
| Many items move with order            | stagger / indexed delay                            |
| Text itself moves                     | line, word, character, or band subdivision         |
| Surface bends, stretches, or crops    | parent/child counter-transform                     |
| UI has states                         | explicit state machine                             |
| Scene has depth                       | DOM 3D, Three.js, or WebGL camera/object keyframes |

Mechanisms can combine, but each one must clarify the idea. Decoration is not proof.

## Timing

- Anticipation only when it clarifies cause or direction.
- Acceleration leaves rest.
- Peak proof shows the mechanism unmistakably.
- Follow-through sells energy and direction.
- Overshoot only when the subject should feel elastic or tactile.
- Constant-speed path travel usually needs `ease: "none"`.
- Discrete UI states usually need a sharp ease-out.
- Repeated elements need ordered offsets, not identical timing.
- Final lockups need longer holds than transition poses.
- Smoothness means continuous velocity on the same subject.
- Do not overlap tweens that write the same transform property unless the overlap is intentional and verified.
- Avoid animating large `clip-path`/mask changes while the same hero surface is also scaling or traveling; use nested reveals after the main move settles.

## Text

Preserve line boxes, word spacing, readability, and final fit. If text moves internally, move the glyphs or masked bands, not only decorations around the text. Snapshot readable frames.

## SVG

For stroke growth prefer `DrawSVGPlugin`, then `stroke-dasharray`/`stroke-dashoffset`. For shape interpolation prefer `MorphSVGPlugin`; convert primitives to paths when needed and split complex silhouettes into simpler parts.

## 3D

Scale alone is fake depth. Use perspective on a stable parent, `transform-style: preserve-3d`, z travel, rotation, camera/world motion, occlusion, and layer order when objects cross.

Use one or two diagnostic angles that expose the depth relationship. If angled proof shows no depth crossing, improve z/camera/occlusion.

## Canvas / WebGL

Keyframe camera position, camera target, object transform, material opacity, shader uniforms, and postprocess intensity through deterministic state. Render from HyperFrames time. Use `--ghost` because marker boxes cannot see internal canvas motion.

## CLI Proof

```bash
npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>
```

Choose `<selector>` for the real animated subject. Choose `<times>` for first frame, proof poses, final-minus-hold, and exact final. Choose `<angle>` only when depth must be proven.

| Tool             | Proves                                                                                              |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| `keyframes`      | targets, explicit stops, paths, traces, composed parent/child motion, CSS stops, Anime registration |
| `--shot`         | ghosts, route shape, time spacing, DOM 3D projection, focused selector proof                        |
| `--layout strip` | in-place motion, overlaps, contact, subtle scale/opacity, text waves                                |
| `--ghost`        | canvas, WebGL, shader motion, rendered 3D                                                           |
| `snapshot --at`  | masks, text readability, full state, final lockup, black/reset tails                                |

If selector proof looks wrong:

1. rerun `--json`
2. find the actual animated target
3. shoot that target
4. snapshot full frames
5. trust painted pixels over logs

## Diagnostic Reading

`flat` means no explicit middle poses. `keyframes` means explicit stops exist. `motionPath` means a route exists. `trace` means multi-stroke drawing. `composed with` means child motion inherits parent motion.

Even ghost spacing means constant speed. Clustered ghosts mean slow-in or settle. Large gaps mean fast travel.

A helper-selector shot is not proof. An onion shot over a broken full frame is not proof.

## Error Handling

| Failure            | Fix                                                                                |
| ------------------ | ---------------------------------------------------------------------------------- |
| endpoint-only      | add middle poses, hold peak proof, rerun `--shot`                                  |
| identity break     | keep one element alive, use shared source/final boxes, remove substitute crossfade |
| fake 3D            | add z/camera travel, occlusion, angled proof                                       |
| wrong final        | add final hold, snapshot final-minus-hold and exact final                          |
| unseekable runtime | pause autoplay, register instance, remove timers, build synchronously              |
| unreadable text    | preserve line boxes, reduce displacement, add final hold, snapshot text frames     |

## Done

Run `hyperframes lint`, `hyperframes check`, `hyperframes keyframes`, one focused `--shot`, and snapshots. Confirm first frame, proof poses, final-minus-hold, exact final, subject-owned motion, and no debug overlays.

© coco-research · MIT · coco-research/coco

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

Все скиллы по теме «Фронтенд и UI» →
hyperframes-registry официальный HeyGen Скилл hyperframes-registry помогает устанавливать блоки и компоненты из реестра HyperFrames и встраивать их в HTML-композиции. CX Codex GP ChatGPT +1 2установок hyperframes-core calesthio Скилл hyperframes-core задаёт правила сборки видеороликов из HTML в HyperFrames: тайминги через data-атрибуты, детерминированный рендеринг и структуру вложенных сцен. CX Codex +1 ★ 78 316звёзд репо hyperframes heygen-com Скилл hyperframes для Claude Code рендерит видео на основе HTML через покадровый обход временной шкалы. CX Codex +1 1 600 000установок remotion-to-hyperframes heygen-com Скилл remotion-to-hyperframes переносит анимации и видеокод из Remotion, Motion Canvas или Lottie в проект HyperFrames. Позволяет проверить результат покадровым сравнением с оригиналом через diff. CX Codex +1 651 200установок css-marker-patterns calesthio Правило css-marker-patterns описывает пять способов обвести текст на чистом CSS и таймлайнах GSAP: подсветку, круг, вспышку, каракули и перечёркивание. CX Codex +1 ★ 78 316звёзд репо css-animations boraoztunc Скилл css-animations помогает настроить CSS-анимации для HyperFrames так, чтобы плеер мог детерминированно перематывать кадры при рендеринге и превью. CX Codex +1 271установок

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

Весь набор →
multi-cursor-choreography Правило multi-cursor-choreography для Claude Code ставит несколько курсоров на общий canvas и задаёт им непересекающиеся действия. Подключается для анимации командной работы. CX Codex +1 ★ 328звёзд репо architecture Слэш-команда architecture фиксирует, что в прогоне /team считается соответствием архитектуре, и требует под каждое такое утверждение запуск валидатора с кодом выхода. CX Codex +1 ★ 328звёзд репо toolkit Команда toolkit сопоставляет задачи проекта с инструментами и скиллами, отмечая лучший вариант, запасной и случаи пропуска; работает внутри прогонов /team. CX Codex +1 ★ 328звёзд репо arch-index Создаёт проверяемую карту компонентов репозитория в .arch/index.json и ищет расхождения с кодом. Пригодится после рефакторинга или когда нужно понять, какие файлы реализуют компонент. CX Codex +1 ★ 328звёзд репо pmstudio-meeting-notes Скилл pmstudio-meeting-notes превращает транскрипты встреч в структурированные Markdown-заметки. Сверяет участников со справочником стейкхолдеров, фиксирует решения и отмечает влияние на PRD. CX Codex +1 ★ 328звёзд репо hyperframes-cli Скилл hyperframes-cli помогает вести проект HyperFrames от проверки композиции до предпросмотра и рендера. Пригодится и для поиска ошибок сборки или рендера. CX Codex +1 ★ 328звёзд репо _index Слэш-команда _index для Claude, которая читает, ищет и разбирает почту Outlook через подкоманды вроде unread, summary и triage. CX Codex +1 ★ 328звёзд репо brain:wiki Скилл brain:wiki для Claude Code ищет, создаёт и объединяет статьи о людях, системах и командах из распределённой базы знаний. Помогает получить сводку по сущности или найти информацию о решениях и связях. CX Codex +1 ★ 328звёзд репо

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

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