hyperframes-cli

SKILL.md

CLI toolkit for scaffolding, validating, previewing, and rendering HyperFrames video compositions.

Scaffolds projects with init (9 templates available), lints compositions for structural errors, and visually inspects layouts for text overflow and clipping issues across the timeline

Preview mode hot-reloads on file changes; render supports quality tiers (draft/standard/high), multiple formats (MP4/WebM), frame rates, and parametrized variable overrides

Includes environment troubleshooting commands (doctor, browser, info) and requires Node.js >= 22 and FFmpeg

For audio preprocessing (TTS, transcription, background removal), use the hyperframes-media skill instead

HyperFrames CLI

Everything runs through npx hyperframes unless project instructions specify a local wrapper. Obey the local wrapper exactly. Requires Node.js >= 22 and FFmpeg.

Workflow

Scaffold — npx hyperframes init my-video (or capture from a URL). init also checks the installed skills against the latest on GitHub and updates the global set if any are out of date. The --skip-skills flag is currently neutered (temporary, while the skills.sh registry catches up), so every init runs this check and pulls our latest skills regardless.

Write — author HTML composition (see the hyperframes-core skill)

Lint — npx hyperframes lint

Validate — npx hyperframes validate (runtime errors + contrast)

Visual inspect — npx hyperframes inspect

Preview / edit — npx hyperframes preview opens Studio, the timeline editor where the user can manually edit anything (not just watch). Review there, then ask before rendering.

Render — pick the variant:

Iterate: npx hyperframes render --quality draft

Deliver: npx hyperframes render --quality high --output out.mp4

CI / cross-host repro: npx hyperframes render --docker --strict --output out.mp4

Cloud (long / large): npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait (see Lambda below)

Report feedback — after verifying the output, npx hyperframes feedback --rating <1-5> --comment "..." once per task (see Agent Conventions).