hyperframes-cli

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

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/zamansepeti43/c-rak-agent --skill hyperframes-cli-zamansepeti43
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/zamansepeti43/c-rak-agent/tree/main/video-engine/.agents/skills/hyperframes-cli
Command: npx skills add https://github.com/zamansepeti43/c-rak-agent --skill hyperframes-cli-zamansepeti43

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building programmatic videos with HyperFrames involves many CLI commands (init, lint, validate, inspect, preview, render, lambda) with non-obvious ordering, flags, and failure modes. This Skill gives an AI agent the exact workflow, conventions, and troubleshooting references so it runs the right command at the right time and avoids common pitfalls like rendering before user review or misconfiguring 4K output. ## Core Features & Use Cases - Full dev-loop guidance: Scaffold projects with init or capture, then run the correctness pipeline (lintvalidateinspectsnapshot) before previewing in Studio and rendering. - Agent-safe conventions: Rules for --json output, non-TTY detection, doctor gating on the ok field, user-gated rendering, and post-render output verification. - AWS Lambda cloud rendering: Deploy, render, monitor, and tear down distributed rendering stacks for long videos, 4K output, or large parallel batches. - Use Case: An agent scaffolds a product-promo video, lints and validates the composition, captures snapshot frames to verify sub-compositions mount correctly, opens Studio preview for the user, and only renders the final MP4 after approval. ## Quick Start Ask the agent to scaffold a new HyperFrames video project and run lint, validate, and inspect 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, then verify the output file exists and has plausible size.

How do I validate a HyperFrames composition before rendering?

Run lint, validate, and inspect in that order. Lint catches structural errors, validate loads the composition in headless Chrome to report runtime errors and WCAG contrast issues, and inspect checks text overflow and motion intent across the timeline.

When should I use HyperFrames Lambda rendering 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. Stay on local render for dev-loop iteration and short 1080p videos, since Lambda adds deploy overhead.

Why does my HyperFrames render fail with Chrome or FFmpeg errors?

Run npx hyperframes doctor first to diagnose the environment; it checks Node.js version, FFmpeg, Chrome, Docker, and system resources. Missing bundled Chrome can be fixed with npx hyperframes browser ensure.

Why does my 4K HyperFrames render still output 1080p?

Setting --width 3840 --height 2160 is ignored when the composition declares data-width="1920". Use --output-resolution 4k instead, which supersamples via Chrome deviceScaleFactor without re-laying-out the composition.

Can HyperFrames CLI run non-interactively in CI pipelines?

Yes, the CLI auto-detects non-TTY environments and switches to non-interactive mode, where init requires the --example flag. Use --json on supported commands and gate doctor on the payload's ok field since it always exits 0.