hyperframes-cli

Validates, previews, and renders HyperFrames video compositions via the npx CLI.

9|Updated May 8, 2026
One-click install
npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill hyperframes-cli-simpletibr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-cli
Source: https://github.com/simpletibr/simplicio-loop-marketing/tree/main/.skills/hyperframes-cli
Command: npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill hyperframes-cli-simpletibr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It provides a controlled dev loop for HyperFrames video compositions, ensuring every piece passes lint and layout inspection before rendering so malformed compositions never reach the publish step. ## Core Features & Use Cases - Validation pipeline: Runs lint and inspect with JSON output, treating error-level findings as blockers and resolving text overflow or canvas escape before render. - Parameterized rendering: Executes render with configurable fps, quality, format, strict mode, and JSON variable overrides, then verifies the output MP4 exists and is non-zero. - Environment diagnostics: Uses doctor, browser, and info commands to detect missing FFmpeg or Chrome before attempting renders. - Use Case: After a prompt-builder skill produces a composition under outputs/<client>/<date>/<piece-id>/, run lint and inspect, fix flagged overflow, then render a strict, high-quality MP4 and log usage metrics to data/video-usage.jsonl. ## Quick Start Run the HyperFrames CLI in lint mode against the project at outputs/acme/2024-06/piece-01 and report any blocking errors before rendering.

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 with the project path, passing flags like --fps, --quality, --strict, --strict-variables, and --variables as a single-line JSON string. Always run lint and inspect first, since the pipeline has no recovery path for malformed compositions.

How do I validate a HyperFrames project before rendering?

Run npx hyperframes lint with --json to catch markup errors, then npx hyperframes inspect to audit layout issues like text overflow or canvas escape. Treat error-level findings as blockers and fix the markup rather than silencing rules globally.

What are the system requirements for the HyperFrames CLI?

The CLI requires Node.js version 22 or higher and FFmpeg available on PATH, plus Chrome for capture during rendering. Run npx hyperframes doctor to verify the environment before attempting any render.

Why does HyperFrames render fail with an unknown variable error?

This happens when a key passed via --variables is not declared in the composition's data-composition-variables. Fix the markup to declare the variable or remove the override; with --strict-variables enabled, typos fail loudly instead of falling back to defaults.

What should I do when the rendered MP4 has zero bytes?

Re-run npx hyperframes doctor, since a zero-byte output is almost always caused by a Chrome crash mid-capture. Do not attempt workarounds; resolve the environment issue first.

Can the HyperFrames CLI handle audio transcription or background removal?

No, asset preprocessing tasks like tts, transcribe, and remove-background are explicitly out of scope for this skill. They are intended to be handled by a separate hyperframes-media skill rather than inlined into the render loop.