hyperframes-cli

Orchestrates the HyperFrames CLI workflow for authoring, checking, previewing, and rendering video compositions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Authoring programmatic videos requires a disciplined loop of scaffolding, linting, browser-based checks, preview approval, and rendering, and doing these steps out of order produces broken or unverified output. This Skill encodes the complete HyperFrames CLI development loop so agents and developers run the right command at the right stage, locally or on cloud infrastructure. ## Core Features & Use Cases - Full development loop: scaffold projects with init or capture, search the motion catalog before hand-authoring animation, lint while editing, and gate final output with check before preview and render. - Multi-target rendering: render locally with quality tiers (draft, looks, delivery), or distribute renders to HeyGen-hosted cloud, AWS Lambda, or Google Cloud Run with JSONL batch support. - Diagnostics and verification: use doctor, snapshot, motion sidecar assertions, and Studio selection context to diagnose build, layout, contrast, and render failures. - Use Case: A user asks an agent to turn a captured website into a rendered MP4; the Skill directs the agent to capture the URL, lint and check the composition, open a Studio preview for approval, then render and verify the output with ffprobe. ## Quick Start Ask the agent to scaffold a new HyperFrames project, run the lint and check gates, open the Studio preview for review, and render the approved composition to an MP4 file.

Frequently Asked Questions about hyperframes-cli

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

FAQPage Schema
How do I render a HyperFrames composition to MP4?▼

Run npx hyperframes render --quality looks --output out.mp4 after the composition passes npx hyperframes check and the user approves the Studio preview. Verify the output exists, is non-empty, and matches the expected duration with ffprobe.

What is the difference between hyperframes lint and check?▼

lint is a fast static analysis for iteration feedback, while check is the required final gate that reruns lint and then audits runtime errors, layout, motion assertions, and WCAG contrast in one browser session. Do not run a standalone lint immediately before check.

Should I use cloud render, Lambda, or Cloud Run for HyperFrames?▼

Use hyperframes cloud render for zero-infrastructure HeyGen-hosted rendering, lambda render only when AWS ownership is required, and cloudrun render only when GCP ownership is explicit. Local render remains the fastest option for iteration.

Why does hyperframes render fail with a Chrome or FFmpeg error?▼

Run npx hyperframes doctor first to diagnose the environment; it checks Node.js version, FFmpeg, Chrome, memory, and Docker. Missing bundled Chrome is fixed with npx hyperframes browser ensure, and agent sandboxes that block Chrome require rendering via --docker or cloud.

How do I render personalized video batches with HyperFrames?▼

Declare variables in the composition with data-composition-variables, then run render --batch rows.json locally or render-batch with a JSONL file on Lambda or Cloud Run. Each row supplies one variable set, and --strict-variables validates rows before rendering.

When should I not render a HyperFrames project?▼

Never render merely because checks pass; the workflow requires pausing at the final Studio preview and waiting for explicit user approval. Also treat a blocked capture (non-zero exit or BLOCKED.md) as a hard stop with no rendering.