hyperframes-core
HyperFrames composition contract для создания одного рендерного проекта. Используется для структуры композиции, атрибутов timing, треков, переменных и правил рендеринга. Читайте перед написанием composition HTML.
AIcalesthio
official
Разработка
★ 64.9k
Что делает навык
HyperFrames Core — это технический контракт для создания HTML-композиций, которые рендерятся в видео с помощью фреймворка HyperFrames. Он определяет структуру DOM, атрибуты timing, треки, переменные и правила рендеринга, обеспечивая детерминированность и возможность перемотки анимации.
Когда применять
- Создание нового рендерного проекта с нуля (standalone или sub-composition).
- Редактирование существующей композиции с сохранением таймингов, треков и ID.
- Настройка треков, перекрытий (z-index) и относительного времени клипов.
- Подключение переменных и медиафайлов (video/audio) с управлением громкостью и обрезкой.
- Авторизация раскадровки (STORYBOARD.md) или сценария (SCRIPT.md) для планирования.
Как работает
- Выбрать тип композиции: standalone (root div в body) или sub-composition (root в template с точным совпадением data-composition-id).
- Задать явные размеры для корня (width/height в px) и обеспечить resolved height для всех предков до height:100%, чтобы избежать коллапса макета.
- Использовать data-атрибуты (data-track-index, data-duration и др.) для объявления тайминга, треков и переменных в DOM.
- Разместить медиафайлы (<video>/<audio>) прямыми дочерними элементами корня композиции, не помещая их внутрь sub-comp template.
- Анимировать только свойства из разрешенного списка (visual-property allowlist), избегая display/visibility и render-time клоков.
- Проверить проект через hyperframes-cli (lint, validate, inspect) и при наличии sub-compositions сделать snapshot-проверку кадров.
Примеры запросов агенту
Создай HTML-композицию для HyperFrames с таймингом 5 секунд, одним треком и фоновым видео.
Отредактируй существующую композицию: добавь новый клип на трек 2, не нарушая существующие ID и тайминги.
Настрой sub-composition, обернув корень в template, и свяжи его с хостом через data-composition-src.
Что понадобится
- Среда с установленным hyperframes-cli (npx hyperframes).
- Доступ к репозиторию openmontage для чтения справочных материалов (references/).
- Понимание структуры DOM и атрибутов data-* для объявления тайминга.
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «calesthio-hyperframes-core» из репозитория:
# https://github.com/calesthio/openmontage
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r calesthio-hyperframes-core/ ~/.claude/skills/calesthio-hyperframes-core/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.