AIKraft/Skills/hyperframes-core

hyperframes-core

HyperFrames composition contract для создания одного рендерного проекта. Используется для структуры композиции, атрибутов timing, треков, переменных и правил рендеринга. Читайте перед написанием composition HTML.

calesthio official Разработка ★ 64.9k

Что делает навык

HyperFrames Core — это технический контракт для создания HTML-композиций, которые рендерятся в видео с помощью фреймворка HyperFrames. Он определяет структуру DOM, атрибуты timing, треки, переменные и правила рендеринга, обеспечивая детерминированность и возможность перемотки анимации.

Когда применять

  • Создание нового рендерного проекта с нуля (standalone или sub-composition).
  • Редактирование существующей композиции с сохранением таймингов, треков и ID.
  • Настройка треков, перекрытий (z-index) и относительного времени клипов.
  • Подключение переменных и медиафайлов (video/audio) с управлением громкостью и обрезкой.
  • Авторизация раскадровки (STORYBOARD.md) или сценария (SCRIPT.md) для планирования.

Как работает

  1. Выбрать тип композиции: standalone (root div в body) или sub-composition (root в template с точным совпадением data-composition-id).
  2. Задать явные размеры для корня (width/height в px) и обеспечить resolved height для всех предков до height:100%, чтобы избежать коллапса макета.
  3. Использовать data-атрибуты (data-track-index, data-duration и др.) для объявления тайминга, треков и переменных в DOM.
  4. Разместить медиафайлы (<video>/<audio>) прямыми дочерними элементами корня композиции, не помещая их внутрь sub-comp template.
  5. Анимировать только свойства из разрешенного списка (visual-property allowlist), избегая display/visibility и render-time клоков.
  6. Проверить проект через 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 и совместимые) подхватывает его по описанию и следует шагам.