hyperframes-core

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

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/AnderHonorato/Mem-rias-IA---Infinity --skill hyperframes-core-anderhonorato
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-core
Source: https://github.com/AnderHonorato/Mem-rias-IA---Infinity/tree/main/Manus/Skills/html-video-production/references/hyperframes-core
Command: npx skills add https://github.com/AnderHonorato/Mem-rias-IA---Infinity --skill hyperframes-core-anderhonorato

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gsap, and includes references (resource) components.

What problem does it solve? It defines the technical contract for building HTML-based video compositions that HyperFrames can render deterministically, preventing silent bugs like collapsed layouts, blank media, and non-reproducible frames. ## Core Features & Use Cases - Composition Structure: Declares timing with data-* attributes, class="clip", tracks, and sub-compositions loaded via data-composition-src. - Deterministic Rendering Rules: Enforces a single paused GSAP timeline per composition, bans render-time clocks and unseeded randomness, and restricts animation to a visual-property allowlist. - Planning Formats: Defines the BRIEF.md, STORYBOARD.md, and SCRIPT.md document formats plus the plan-sketch-build review loop. - Use Case: When authoring a multi-scene product launch video, use this contract to structure a thin index.html orchestrator with per-scene sub-compositions, root-level audio, and validated timing before running npx hyperframes check. ## Quick Start Read this skill before writing any composition HTML, then start from the minimal composition skeleton and validate 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 video composition from 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. Validate with npx hyperframes check.

What is the difference between a standalone composition and a sub-composition in HyperFrames?

A standalone composition is a top-level index.html whose root sits directly in body with no template wrapper. A sub-composition is loaded via data-composition-src and its root must be wrapped in a template element, since the runtime only clones template contents.

Why does my HyperFrames video render black or blank?

Common causes are video or audio elements nested inside a sub-composition template instead of being direct children of the host root, duplicate media ids across files, or a full-screen background set on the composition root instead of a full-bleed child element.

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

No. The renderer seeks frames by time, so render-time clocks, unseeded Math.random, network fetches, input state, and infinite repeats are banned. Use a seeded PRNG and finite repeat counts computed with Math.floor.

Does HyperFrames support Tailwind or non-GSAP runtimes like Three.js?

Yes, Tailwind v4 projects are supported via init --tailwind, and CSS, WAAPI, Lottie, and Three.js runtimes work through adapters. Three.js cannot auto-infer duration, so a root data-duration is required for it.