hyperframes-cli

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It guides agents through the full HyperFrames CLI development loop for HTML-based video compositions, preventing common mistakes like rendering before approval, skipping lint/check gates, or choosing the wrong render backend. ## Core Features & Use Cases - Development loop orchestration: Scaffold projects with init or capture, search the motion catalog, lint iteratively, and run the check gate before preview and render. - Multi-backend rendering: Choose between local render, Docker, HeyGen-hosted cloud, AWS Lambda, or Google Cloud Run, including variable-driven batch renders. - Diagnostics and feedback: Diagnose environment failures with doctor and browser commands, capture snapshots of findings, and submit structured feedback reports. - Use Case: An agent scaffolding a product promo video runs init, searches the catalog for a headline reveal, authors the composition, passes check, opens a Studio preview for user approval, then renders a high-quality MP4. ## Quick Start Ask the agent to scaffold a new HyperFrames video project and run the lint and check gates before previewing it in Studio.

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 video composition to MP4?▼

Run npx hyperframes render --quality high --output out.mp4 after the composition passes the check gate and the user approves the Studio preview. 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 cloud render, Lambda, or Cloud Run for HyperFrames?▼

Use hyperframes 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 iteration.

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

Run npx hyperframes doctor first to diagnose missing FFmpeg, missing bundled Chrome, low memory, or sandbox restrictions. Fix missing Chrome with npx hyperframes browser ensure, and note that doctor --json always exits zero so gate on its payload.

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 failures.

When should I not run hyperframes render?▼

Never render merely because checks pass; pause at the final Studio preview and wait for explicit user approval. Also avoid the deprecated validate, inspect, and layout aliases, which are replaced by check.