hyperframes-core

Defines the composition contract for building renderable HyperFrames HTML video projects.

13|17|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-core-codewithsally
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-core
Source: https://github.com/CodeWithSally/CodeWithSally-Apex-English/tree/main/Sessions/ClaudeCode/Session007/.agents/skills/hyperframes-core
Command: npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-core-codewithsally

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a video composition in HyperFrames requires strict structural rules — data-* timing attributes, clip visibility, track layout, sub-composition wiring, and deterministic animation — and violating them produces silent render bugs that automated checks miss. This Skill encodes that contract so compositions render correctly the first time. ## Core Features & Use Cases - Composition structure rules: Standalone vs sub-composition root forms, sized roots, one paused GSAP timeline per composition registered on window.__timelines, and host-id matching requirements. - Timing and editing contracts: data-start/data-duration/data-track-index semantics, clip visibility windows, and copyable recipes for cuts, trims, reorders, retiming, freezes, crossfades, and audio ducking. - Determinism and validation gates: Bans on render-time clocks, unseeded randomness, and infinite repeats, plus a check → snapshot → preview → render validation workflow. - Use Case: When asked to build a 30-second modular video with three scenes and background music, use this Skill to structure index.html with sub-composition slots, keep audio on a separate track, and pass npx hyperframes check before rendering. ## Quick Start Use the hyperframes-core skill to scaffold a minimal renderable composition and validate it 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 renderable HyperFrames composition in HTML?

Create a root element with data-composition-id, data-width, data-height, data-start="0", and data-duration, then register one paused GSAP timeline at window.__timelines keyed by the composition id. Timed children use class="clip" with data-start, data-duration, and data-track-index.

How do I add a sub-composition in HyperFrames?

Wrap the sub-composition root in a template tag, keep its style and script inside the template, and load it from the host with data-composition-src. The host slot's data-composition-id must exactly match the inner template's id and its window.__timelines key.

Why does my HyperFrames composition render blank or unstyled?

Common causes are duplicate media element ids across files, a background painted on the composition root instead of a full-bleed child, or an unsized root collapsing to zero height. Style sub-composition roots via #root, never a class on the data-composition-id element.

Can I use video and audio elements inside a HyperFrames sub-composition?

Yes, video and audio work at any nesting depth, including inside a sub-composition template, because the framework owns playback and seeks media wherever it lives. The limitation is that a sub-composition timeline cannot animate host-root elements.

What animation patterns are forbidden in HyperFrames renders?

Render-time clocks, unseeded Math.random, network fetches, input-state dependencies, and infinite repeats like repeat: -1 are banned because frames must be reproducible from time alone. Only tween the visual-property allowlist and never animate display or raw visibility on clip elements.

How do I validate a HyperFrames project before rendering?

Run npx hyperframes check and confirm zero findings across lint, runtime, layout, motion, and contrast. For projects with sub-compositions, run npx hyperframes snapshot at scene midpoints and inspect frames, then preview before rendering only after user approval.