hyperframes-cli

Operate the HyperFrames CLI to scaffold, check, preview, and render video compositions.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill hyperframes-cli-marshal-nguyen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/Marshal-Nguyen/Skill_Claude_Agent/tree/main/claude/skills/hyperframes-cli
Command: npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill hyperframes-cli-marshal-nguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Authoring and rendering HyperFrames video compositions involves many CLI commands, gates, and render targets; this Skill encodes the correct development loop so agents lint, check, preview, and render in the right order without skipping approval gates or misusing deprecated commands. ## Core Features & Use Cases - Full development loop: scaffold with init or capture, iterate with lint, gate with check, review in Studio via preview, then render locally with quality tiers. - Multiple render targets: local Chrome/FFmpeg rendering, Docker reproducible renders, HeyGen-hosted cloud rendering, AWS Lambda, and Google Cloud Run distributed rendering with JSONL batch support. - Diagnostics and verification: doctor environment checks, motion sidecar assertions, snapshot capture, sub-composition smoke tests, and structured feedback reporting. - Use Case: An agent scaffolds a product promo video, runs npx hyperframes check --snapshots to catch layout and contrast errors, opens Studio preview for user approval, then renders a high-quality MP4 and verifies the output file. ## Quick Start Ask the agent to scaffold a new HyperFrames project with npx hyperframes init, then run the lint and check gates before previewing and rendering the composition.

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 high --output out.mp4 after the check gate passes and the user approves the Studio preview. Use --quality draft for fast iteration and verify the output file exists, is non-empty, and has a plausible 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 plus runtime, layout, motion, and WCAG contrast audits in one browser session. Do not run a standalone lint immediately before check since check already includes it.

Should I use hyperframes cloud, Lambda, or Cloud Run rendering?▼

Use cloud render for zero-infrastructure HeyGen-hosted rendering, Lambda only when AWS ownership is required, and Cloud Run only when GCP ownership is explicit. Local render remains the fastest option for the authoring iteration loop.

Why does hyperframes render fail with Chrome or FFmpeg errors?▼

Run npx hyperframes doctor first to diagnose missing FFmpeg, absent bundled Chrome, or low memory. Fix missing Chrome with npx hyperframes browser ensure; in agent sandboxes that block Chromium, render via --docker or cloud instead.

How do I render personalized video batches with variables?▼

Declare variables in the composition with data-composition-variables, then run render --batch rows.json with an output template like renders/{name}.mp4. Use --strict-variables to validate every row before rendering and inspect the generated manifest.json for per-row status.

What are the system requirements for the HyperFrames CLI?▼

The CLI requires Node.js 22 or newer and FFmpeg installed on the host. Docker is only needed for render --docker, and cloud rendering removes the local Chrome and FFmpeg requirement entirely.