hyperframes-cli

Orchestrates the HyperFrames CLI dev loop for scaffolding, validating, previewing, and rendering HTML video compositions.

2|1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/zester4/zilmate --skill hyperframes-cli-zester4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/zester4/zilmate/tree/main/.agents/skills/hyperframes-cli
Command: npx skills add https://github.com/zester4/zilmate --skill hyperframes-cli-zester4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building programmatic videos with HyperFrames involves many CLI commands, environment pitfalls, and quality gates; this Skill guides agents through the correct command sequence so compositions are linted, validated, inspected, previewed, and rendered without missed steps or silent failures. ## Core Features & Use Cases - Full dev-loop orchestration: Covers init, capture, lint, validate, inspect, snapshot, preview, play, render, publish, doctor, and browser commands with correct flags and ordering. - Cloud rendering on AWS Lambda: Entry point for hyperframes lambda deploy / render / progress / destroy / policies for long, 4K, or parallel batch renders. - Quality gates and CI conventions: Enforces lint/validate/inspect before preview, user approval before render, --json and --strict usage, and post-render output verification. - Use Case: An agent scaffolds a product promo video from a URL with capture, runs lint/validate/inspect, opens Studio preview for user review, then renders a high-quality MP4 locally or via Lambda. ## Quick Start Ask the agent to scaffold a new HyperFrames video project and run the lint, validate, and inspect checks before opening the Studio preview.

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 video with the HyperFrames CLI?

Run npx hyperframes render after the user approves the preview in Studio. Use --quality draft while iterating and --quality high --output out.mp4 for final delivery; verify the output file exists and has plausible size afterward.

How do I check a HyperFrames composition for errors before rendering?

Run npx hyperframes lint, then validate, then inspect in that order. Lint catches structural issues, validate loads the composition in headless Chrome for runtime and contrast errors, and inspect reports text overflow and motion-intent failures.

When should I use hyperframes lambda instead of local render?

Use lambda render for long videos, 4K output, or large parallel batches where local Chrome would time out or exhaust memory. Local render is better for dev-loop iteration and short 1080p renders since Lambda adds deploy overhead.

Why does hyperframes doctor exit 0 even when the environment is broken?

doctor --json always exits 0 by design so pipelines are insulated from CLI release churn. Gate on the payload's ok field instead, for example with jq -e '.ok'.

Why does my sub-composition render blank even though lint and validate pass?

Lint, validate, and inspect evaluate each composition in isolation and never mount sub-compositions via index.html. Run npx hyperframes snapshot at scene midpoints to catch cross-file mount failures like mismatched host and template ids.

Does hyperframes init work in non-interactive CI environments?

Yes, the CLI auto-detects non-TTY output and switches to non-interactive mode, but init then requires the --example flag. You can also pass --non-interactive explicitly to force flag-only mode on a TTY.