hyperframes-core

Builds renderable HyperFrames video compositions from HTML with data-attribute timing and GSAP timelines.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/Sergiotsk/Interstellar --skill hyperframes-core-sergiotsk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes-core
Source: https://github.com/Sergiotsk/Interstellar/tree/main/.agents/skills/hyperframes-core
Command: npx skills add https://github.com/Sergiotsk/Interstellar --skill hyperframes-core-sergiotsk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Authoring video compositions in HyperFrames requires strict adherence to a technical contract: correct data-* timing attributes, a single paused GSAP timeline registered under the right key, framework-owned media playback, and deterministic rendering rules. Violating any of these produces silent bugs, lint errors, or blank renders that are hard to diagnose. ## Core Features & Use Cases - Composition structure guidance: Covers standalone vs sub-composition root forms, modular orchestrator patterns, host wiring, and naming conventions for multi-scene projects. - Timing and media rules: Documents data-start, data-duration, data-track-index, relative clip references, video/audio placement, volume automation, and editing recipes (cuts, trims, crossfades, freeze frames). - Validation workflow: Defines the lint, snapshot, preview, and render checklist so compositions pass npx hyperframes check before rendering. - Use Case: You need to build a 30-second modular video with intro, body, and outro scenes plus background music. This Skill tells you exactly how to wire the sub-composition slots, register timelines, and avoid the lint errors that break a first build. ## Quick Start Read this Skill before writing any HyperFrames composition HTML, then validate the result with npx hyperframes check.

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 and data-duration, then register one paused GSAP timeline at window.__timelines keyed by the composition id. Validate with npx hyperframes check before rendering.

How do sub-compositions work in HyperFrames?▼

A sub-composition is a separate HTML file whose content is wrapped in a template element, loaded by a host clip via data-composition-src. The host's data-composition-id must match the file's internal id and its timeline registry key, and styles and scripts must live inside the template.

Why does my HyperFrames render show no animation?▼

A common cause is a mismatch between the host data-composition-id and the registered timeline key, which leaves the render frozen at t=0. Registering an empty timeline before an async build finishes also renders blank, so assign the key only after all tweens are added.

Can I use GSAP with CSS transforms in HyperFrames?▼

Do not pair a CSS initial transform with a GSAP tween on the same property, because lint rejects it with gsap_css_transform_conflict. Set the initial state inside the tween using gsap.fromTo or xPercent and yPercent instead.

What are the limitations of HyperFrames animation?▼

Rendered frames must be deterministic, so render-time clocks, unseeded Math.random, network fetches, input state, and infinite repeats are banned. You also cannot tween display, visibility, or autoAlpha on clip elements, since the framework owns clip visibility.