# hyperframes-keyframes

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 328 у репозитория
- Автор: coco-research
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/coco-research/coco/tree/HEAD/systems/hyperframes/skills/hyperframes-keyframes/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`; бренд-дизайн, подбор медиа и субтитры остаются вне его зоны.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill hyperframes-keyframes -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/hyperframes-keyframes/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/hyperframes-keyframes/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill hyperframes-keyframes -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/hyperframes-keyframes/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill hyperframes-keyframes -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/hyperframes-keyframes/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install coco-research/coco systems/hyperframes/skills/hyperframes-keyframes
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/hyperframes-keyframes/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill hyperframes-keyframes -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/coco-research/coco --path systems/hyperframes/skills/hyperframes-keyframes
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/hyperframes-keyframes/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/coco-research/coco/tree/HEAD/systems/hyperframes/skills/hyperframes-keyframes/SKILL.md

## Когда брать
- Сделать анимацию, которая корректно перематывается при покадровом рендере
- Собрать таймлайн 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-registry](https://affpapa.org/nevibecode/skills/hyperframes-registry.md) — скилл · 2 установки
- [hyperframes-core](https://affpapa.org/nevibecode/skills/hyperframes-core.md) — скилл · ★ 78316 у репозитория
- [hyperframes](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes.md) — скилл · 1600000 установок
- [remotion-to-hyperframes](https://affpapa.org/nevibecode/skills/remotion-to-hyperframes.md) — скилл · 651200 установок
- [css-marker-patterns](https://affpapa.org/nevibecode/rules/css-marker-patterns.md) — правило · ★ 78316 у репозитория
- [css-animations](https://affpapa.org/nevibecode/skills/css-animations.md) — скилл · 271 установка

Из того же набора: [coco-research/coco](https://affpapa.org/nevibecode/by/coco-research/coco.md) — 82 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
