hyperframes-core

Defines the HTML composition contract for rendering deterministic video with HyperFrames.

Updated Jun 20, 2026
One-click install
npx skills add https://github.com/Noetfield-Systems/SourceA --skill hyperframes-core-noetfield-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-core
Source: https://github.com/Noetfield-Systems/SourceA/tree/main/commercial-video-factory/trustfield-storyboard-hf-v1/.agents/skills/hyperframes-core
Command: npx skills add https://github.com/Noetfield-Systems/SourceA --skill hyperframes-core-noetfield-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building videos from HTML requires strict structural and timing rules so every rendered frame is reproducible from a time value alone; this Skill encodes the HyperFrames composition contract so compositions render correctly instead of failing silently. ## Core Features & Use Cases - Composition Structure Rules: Defines standalone vs sub-composition root forms, the <template> transport requirement, sized-root layout, and host-id matching so sub-compositions mount correctly. - Timeline & Determinism Contract: Specifies the paused GSAP timeline registered on window.__timelines, synchronous construction, seeded randomness, finite repeat formulas, and the animatable-property allowlist. - Tracks, Clips, Variables & Media: Documents data-* attributes, track-index overlap rules, relative clip timing, variable declarations, and the rule that <video>/<audio> must be direct host-root children. - Use Case: When authoring a modular product video with scene sub-compositions and a continuous audio track, follow the orchestrator pattern and pre-render verification checklist to avoid blank media and unregistered timelines. ## Quick Start Use the hyperframes-core skill to scaffold a minimal renderable HyperFrames composition with one clip and a registered GSAP timeline.

Frequently Asked Questions about hyperframes-core

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

FAQPage Schema
How do I create a minimal renderable HyperFrames composition?

Create an HTML file with a sized root div carrying data-composition-id, data-width, data-height, and data-duration, plus at least one clip with data-start, data-duration, and data-track-index. Register a paused GSAP timeline at window.__timelines keyed by the composition id.

How do I structure sub-compositions in HyperFrames?

Wrap the sub-composition root, styles, and scripts inside a template element, since the runtime clones only template contents. The host slot's data-composition-id must exactly match the inner template's id and the window.__timelines key.

Why does my video element render black in a HyperFrames render?

Video and audio elements must be direct children of the host composition root in index.html. Media inside a sub-composition template or a wrapper div is never decoded, and lint, validate, and inspect do not catch this.

Can I use Math.random or repeat -1 in HyperFrames animations?

No. Rendered frames must be reproducible from time alone, so use a seeded PRNG instead of Math.random and compute finite repeats with Math.floor(duration / cycleDuration) - 1 instead of repeat: -1.

Does HyperFrames support Tailwind in compositions?

Yes, projects scaffolded with hyperframes init --tailwind use the pinned @tailwindcss/browser 4.2.4 runtime with @theme and @utility blocks. Avoid v3 directives, responsive breakpoints, transitions, and interaction variants during render.

What is the difference between data-track-index and CSS z-index?

data-track-index controls temporal overlap: clips on the same track must not overlap in time. Visual stacking order is controlled separately by CSS z-index, not by track numbers.