hyperframes-cli

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

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill hyperframes-cli-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/hyperframes-cli
Command: npx skills add https://github.com/Chau165/local_skill --skill hyperframes-cli-chau165

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and 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 scaffold, lint, check, preview, and render projects without skipping mandatory audits or approval steps. ## Core Features & Use Cases - Full development loop: Covers init, capture, catalog, add, lint, check, snapshot, preview, render, publish, and feedback, with strict rules such as running the world-motion audit before any non-presentation render. - Multiple render targets: Supports local, Docker, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering, with references detailing each path's flags, batch modes, and prerequisites. - Quality gates and diagnostics: Enforces lint/check gates, motion sidecar assertions, WCAG contrast audits, doctor environment checks, and structured feedback reporting after verified renders. - Use Case: An agent scaffolds a project with npx hyperframes init, authors a composition, runs check --snapshots, opens a Studio preview for user approval, then renders a high-quality MP4 locally or via cloud. ## Quick Start Ask the agent to scaffold a new HyperFrames 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 composition to MP4?

Run npx hyperframes render --quality high --output out.mp4 after the project passes lint, check, and the world-motion audit, 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 and then audits runtime errors, layout, motion sidecar assertions, and WCAG contrast in one browser session. Do not run a redundant standalone lint immediately before check.

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 iteration during authoring.

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 blocking Chrome startup. Fix the reported issue, for example with npx hyperframes browser ensure, then retry the render.

What is the world-motion audit and when is it required?

The world-motion audit validates world-motion.json and composition structure before any non-presentation render, requiring background, environment, and subject layers with animated actor-target interactions. Exit code 2 is a hard block; repair the composition and rerun the audit before rendering.