hyperframes-cli

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

13|17|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-cli-codewithsally
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/CodeWithSally/CodeWithSally-Apex-English/tree/main/Sessions/ClaudeCode/Session007/.agents/skills/hyperframes-cli
Command: npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-cli-codewithsally

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, rendering, and cloud deployment, and using them in the wrong order or with the wrong flags causes failed renders and wasted iterations. This Skill encodes the correct development loop and command contracts so agents and developers run the right command at the right stage. ## Core Features & Use Cases - Guided development loop: Enforces the scaffold → catalog search → author → lint → check → preview → approve → render sequence, including mandatory cross-references to sibling skills before keyframe, audio, or clip edits. - Render path selection: Covers local rendering (draft/standard/high quality, Docker, batch variables), HeyGen-hosted cloud rendering, AWS Lambda, and Google Cloud Run distributed rendering with per-command reference docs. - Diagnostics and feedback: Standardizes doctor/browser environment checks, snapshot-based sub-composition smoke tests, Studio selection context queries, and structured feedback reports with reproduction packets. - Use Case: An agent scaffolding a product promo video runs npx hyperframes init, searches the motion catalog, authors the composition, gates on check --snapshots, opens a Studio preview for user approval, then renders high-quality MP4 output and files a feedback report. ## Quick Start Ask the agent to scaffold a new HyperFrames video project and run the lint, check, and preview loop 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 a HyperFrames composition to MP4?

Run npx hyperframes render --quality high --output out.mp4 after the composition passes npx hyperframes check 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.

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 standalone lint immediately before check since check already includes it.

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

Use hyperframes cloud render for zero-infrastructure hosted rendering on HeyGen, lambda render only when you explicitly need self-managed AWS distributed rendering, and cloudrun render only when GCP ownership is a requirement. Local render remains the default for the authoring loop.

Why does hyperframes render fail with a Chrome or FFmpeg error?

Run npx hyperframes doctor first to diagnose the environment; it checks Node.js version, FFmpeg, Chrome, memory, and Docker. Missing bundled Chrome is fixed with npx hyperframes browser ensure, and sandboxed macOS environments may block Chrome entirely, requiring render --docker or cloud rendering.

How do I render personalized video batches with variables?

Declare variables in the composition with data-composition-variables, then run npx hyperframes render --batch rows.json --output "renders/{name}.mp4" with --strict-variables to validate every row. For high-volume batches, use lambda render-batch or cloudrun render-batch with JSONL input files.

What are the limitations of the hyperframes catalog search?

Catalog search is fully local and indexes an English catalog, so queries must be in English. The default tier ranks on shared vocabulary; add --on-device for meaning-based ranking, which requires a one-time 33 MB model download that should only be enabled with user consent.