hyperframes-cli

Scaffold, lint, inspect, preview, and render HyperFrames video compositions via npx commands.

Updated Oct 16, 2025
One-click install
npx skills add https://github.com/hugotown/dotfiles --skill hyperframes-cli-hugotown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/hugotown/dotfiles/tree/main/agents/skills/hyperframes-cli
Command: npx skills add https://github.com/hugotown/dotfiles --skill hyperframes-cli-hugotown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building HTML-based video compositions requires a repeatable dev loop: scaffolding projects correctly, catching layout and timeline errors before rendering, and producing final MP4 or WebM output. This Skill guides the full HyperFrames CLI workflow so you avoid broken renders, text overflow, and environment misconfiguration. ## Core Features & Use Cases - Project Scaffolding: Run npx hyperframes init with templates like blank, warm-grain, or kinetic-type, with options for video, audio, Tailwind v4, and non-interactive CI mode. - Validation & Visual Inspection: Use lint to catch missing composition IDs and overlapping tracks, and inspect to detect text overflowing bubbles, containers, or the canvas in headless Chrome. - Preview & Render: Serve hot-reloading previews on a custom port and render MP4/WebM output with quality, fps, Docker reproducibility, and parametrized variable overrides. - Use Case: After authoring a composition with speech bubbles, run npx hyperframes inspect --json to get agent-readable overflow findings, fix them, then render a final 60fps high-quality MP4. ## Quick Start Ask the AI to scaffold a new HyperFrames project with the warm-grain template, lint it, and render a draft-quality MP4.

Frequently Asked Questions about hyperframes-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new HyperFrames video project?▼

Run npx hyperframes init my-video to launch the interactive wizard, or pass --example with a template name like warm-grain or blank. Add --video or --audio flags to include media files, and --non-interactive for CI or agent-driven setups.

How do I check a HyperFrames composition for layout errors before rendering?▼

Run npx hyperframes lint to catch structural issues like missing data-composition-id and overlapping tracks, then npx hyperframes inspect to detect text overflowing containers or the canvas. Use --json on either command for machine-readable output.

What are the requirements for running the HyperFrames CLI?▼

HyperFrames requires Node.js version 22 or higher and FFmpeg installed on the system. If rendering fails, run npx hyperframes doctor to check Chrome, FFmpeg, Node, and memory availability.

How do I render a HyperFrames video with custom variables?▼

Pass --variables with a JSON object keyed by variable id, such as --variables '{"title":"Q4 Report"}', to override defaults declared in data-composition-variables. Use --variables-file for a JSON file or --strict-variables to fail on undeclared keys.

Why does my HyperFrames render fail or produce inconsistent output?▼

Common causes are missing FFmpeg, missing Chrome, or low memory, which npx hyperframes doctor can diagnose. For byte-identical reproducible output across machines, use the --docker flag when rendering.