hyperframes-cli

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

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/X-manist/Cohmira --skill hyperframes-cli-x-manist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/X-manist/Cohmira/tree/main/src/builtin-plugins/openmontage/.agents/skills/hyperframes-cli
Command: npx skills add https://github.com/X-manist/Cohmira --skill hyperframes-cli-x-manist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building videos from HTML compositions requires a disciplined loop of scaffolding, linting, runtime validation, layout inspection, previewing, and rendering. This Skill encodes that entire HyperFrames CLI workflow so agents run the right commands in the right order, catch defects before rendering, and avoid common pitfalls like silent 4K misconfiguration or broken sub-composition mounts. ## Core Features & Use Cases - Full dev-loop orchestration: Covers init, capture, lint, validate, inspect, snapshot, preview, play, render, and publish with correct flag usage and ordering rules. - Environment diagnosis: Uses doctor and browser commands to troubleshoot Chrome, FFmpeg, Node.js, and Docker issues when renders or previews fail. - AWS Lambda cloud rendering: Deploys distributed rendering stacks and drives long or 4K renders via lambda deploy / render / progress / destroy / policies. - Use Case: An agent scaffolds a product promo video with npx hyperframes init, lints and validates the composition, captures snapshot frames to verify sub-compositions mount correctly, opens Studio preview for user review, and only renders the final MP4 after approval. ## Quick Start Ask the agent to scaffold a new HyperFrames video project, run lint and validate checks, then open a Studio preview for review before rendering the final MP4.

Frequently Asked Questions about hyperframes-cli

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

FAQPage Schema
How do I render an HTML composition to MP4 with HyperFrames?

Run npx hyperframes render after lint, validate, and preview pass. Use --quality draft for iteration and --quality high --output out.mp4 for delivery. Rendering is user-gated: confirm the preview in Studio before rendering.

How do I scaffold a new HyperFrames video project?

Run npx hyperframes init my-video with an --example flag such as blank or warm-grain. In non-interactive environments like CI or agents, --example is required. You can also scaffold from a live URL using npx hyperframes capture.

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. Local render is better 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 check Node.js version, FFmpeg, Chrome, and Docker status. Missing bundled Chrome is fixed with npx hyperframes browser ensure, and FFmpeg installs via your system package manager.

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

Setting --width 3840 --height 2160 is ignored when the composition's data-width is 1920, because layout uses the authored dimensions. Use --output-resolution 4k instead, which supersamples via Chrome deviceScaleFactor.

How do I verify sub-compositions mount correctly before rendering?

Run npx hyperframes snapshot with --at timestamps or --frames N to capture still frames through the same mount path render uses. Lint, validate, and inspect evaluate compositions in isolation and cannot catch cross-file mount failures.