hyperframes-cli

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Authoring programmatic videos with HyperFrames involves many CLI commands across scaffolding, linting, checking, previewing, and rendering, and running them in the wrong order or without the right gates produces broken renders and wasted iterations. This Skill encodes the correct development loop and command contracts so agents and developers get reliable results. ## Core Features & Use Cases - Guided development loop: Scaffold with init or capture, search the motion catalog with catalog, author compositions, then gate work through lint, check, and preview before any render. - Multi-target rendering: Render locally with quality tiers (draft, looks, delivery), in Docker for reproducibility, or distribute to HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run with batch JSONL support. - Diagnostics and verification: Use doctor, snapshot, compare, grade-compare, and motion sidecar assertions to catch runtime, layout, contrast, and mount defects before delivery. - Use Case: A user asks for a product launch video; the agent scaffolds the project, searches the catalog for a headline reveal, authors the composition, runs check --snapshots, opens a Studio preview for approval, and renders the final MP4 only after sign-off. ## 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 project from the command line?▼

Run npx hyperframes render --quality looks --output out.mp4 after the project passes npx hyperframes check and the preview is approved. Use --quality draft while iterating and --quality delivery for final output, then verify the file exists and is non-empty.

What is the difference between hyperframes lint and hyperframes check?▼

lint is a fast static iteration aid run after HTML edits, while check is the required final gate that reruns lint and then audits runtime errors, layout, motion sidecar assertions, and WCAG contrast in one browser session. Do not run a standalone lint immediately before check.

Should I use hyperframes cloud, lambda, or cloudrun for rendering?▼

Use cloud render for zero-infrastructure HeyGen-hosted rendering, lambda only when AWS ownership is required, and cloudrun 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; it checks Node.js version, FFmpeg, Chrome, memory, and Docker. Missing bundled Chrome is fixed with npx hyperframes browser ensure, and sandboxed hosts that block Chrome require render --docker or cloud rendering.

How do I batch render videos with different variables?▼

Declare variables in the composition with data-composition-variables, then run npx hyperframes render --batch rows.json --output "renders/{name}.mp4". Each JSON row supplies one render's variables, and --strict-variables validates all rows before rendering starts.

What are the limitations of the hyperframes catalog search?▼

Catalog search is fully local and indexes an English catalog, so non-English queries return nothing. The default tier ranks on shared vocabulary; the optional on-device tier ranks by meaning but requires a consented 33 MB model download.