hyperframes-cli

SKILL.md

CLI toolkit for scaffolding, validating, previewing, and rendering HyperFrames video compositions.

Scaffolds projects with init (9 templates available), lints compositions for structural errors, and visually inspects layouts for text overflow and clipping issues across the timeline

Preview mode hot-reloads on file changes; render supports quality tiers (draft/standard/high), multiple formats (MP4/WebM), frame rates, and parametrized variable overrides

Includes environment troubleshooting commands (doctor, browser, info) and requires Node.js >= 22 and FFmpeg

For audio preprocessing (TTS, transcription, background removal), use the hyperframes-media skill instead

HyperFrames CLI

Run commands as npx hyperframes ... unless project instructions provide a wrapper. Obey the wrapper when present. The CLI requires Node.js 22 or newer and FFmpeg.

Development loop

Scaffold: npx hyperframes init <project> or capture a site. In non-TTY mode, pass --non-interactive --example=<name>.

Find the move: before authoring motion by hand, search for a primitive that already does it: npx hyperframes catalog --query "reveal a headline one line at a time". Ask for the effect you want rather than the mechanism you have in mind. Install with npx hyperframes add <name> (see /hyperframes-registry). Author by hand only once nothing fits.

Author: write the composition using /hyperframes-core.

Get fast feedback while editing: run npx hyperframes lint after the first HTML pass and after structural changes.

Run the final gate: run npx hyperframes check; it reruns lint before opening the browser. Do not prepend a redundant standalone lint invocation. Add --snapshots for annotated overview frames and finding crops.

Inspect sub-compositions: when index.html mounts data-composition-src, capture midpoint snapshots and inspect each mounted scene.

Open the final Studio preview: run npx hyperframes preview --background, verify the URL returns HTTP 200, hand the timeline project URL to the user, and ask whether to revise or render. Keep it alive until review ends.

Render only after approval: use draft quality for iteration and high quality for delivery.

Verify the output: confirm the file exists, is non-empty, and has a plausible duration.

Mandatory creator-edit cross-references