hyperframes-core

Build renderable HyperFrames video compositions from HTML with data-attribute timing.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/zamansepeti43/c-rak-agent --skill hyperframes-core-zamansepeti43
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-core
Source: https://github.com/zamansepeti43/c-rak-agent/tree/main/video-engine/.agents/skills/hyperframes-core
Command: npx skills add https://github.com/zamansepeti43/c-rak-agent --skill hyperframes-core-zamansepeti43

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gsap, @tailwindcss/browser, and includes references (resource) components.

What problem does it solve? Writing HTML-based video compositions for HyperFrames requires following a strict contract — data-* timing attributes, clip tracks, sub-composition wiring, deterministic animation, and framework-owned media playback — and violating any rule produces silent render failures that lint and validate do not catch. ## Core Features & Use Cases - Composition Contract: Defines the root element, data-* attributes, class="clip" visibility rules, track overlap rules, and the single paused GSAP timeline registered on window.__timelines. - Sub-Composition Wiring: Documents the template transport rule, host-id matching, per-instance variables, and the three cross-file pitfalls that break renders. - Determinism & Validation: Lists banned patterns (render-time clocks, unseeded randomness, repeat: -1) plus a lint/validate/inspect/snapshot checklist before rendering. - Use Case: You need to build a 30-second product video as a modular HyperFrames project with scene sub-compositions, root-level audio, and a seekable GSAP timeline that renders identically frame by frame. ## Quick Start Read this skill before writing any composition HTML, then scaffold a minimal standalone composition and verify it with npx hyperframes lint, validate, and inspect.

Frequently Asked Questions about hyperframes-core

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a HyperFrames composition in HTML?

Create a root div with data-composition-id, data-width, data-height, and data-duration, add timed clips with data-start, data-duration, and data-track-index, then register one paused GSAP timeline on window.__timelines keyed by the composition id.

How do sub-compositions work in HyperFrames?

A sub-composition is a separate HTML file whose content lives inside a template element, loaded by a host clip with data-composition-src. The host data-composition-id must exactly match the inner template id and the window.__timelines key.

Why does my HyperFrames render show unstyled text or blank video?

Styles or scripts placed in head instead of inside the template are discarded at mount, and video or audio not placed as a direct child of the host root is never decoded. Both pass lint and validate but fail at render.

Can I use Math.random or setTimeout in a HyperFrames composition?

No. Every frame must be reproducible from its time value alone, so render-time clocks, unseeded randomness, network fetches, input state, and infinite repeats like repeat: -1 are banned. Use a seeded PRNG and finite repeat counts.

Does HyperFrames support Tailwind CSS?

Yes, projects scaffolded with npx hyperframes init --tailwind use the pinned @tailwindcss/browser v4 runtime. Use @theme and @utility instead of v3 directives, avoid responsive breakpoints and interaction variants, and keep class tokens static.