hyperframes-cli Skill for Claude: Drive the HyperFrames Video CLI

Teaches your assistant the HyperFrames command line: create a video project, check it, preview it, edit the timeline and render an MP4.

Installs: 1.4M; on skills.sh
Stars: 77.1K; on GitHub
Files: 12; besides SKILL.md
Updated: Nov 2026; last repo commit

hyperframes-cli is the command reference for HeyGen's HyperFrames, which renders HTML to video. It maps each job (start a project, check it, look at frames, edit clips, render locally or in the cloud, publish) to the right npx hyperframes command, and says how to read the JSON output and recover from failures.

It needs Node.js 22+ and FFmpeg. The commands it runs create files in your project, render video, and some (cloud, publish) run off your machine. Use it together with the main hyperframes skill, which holds the rules for what a video file must contain.

Good for

Developers making videos from HTML with Claude Code, Codex or Cursor
Anyone who wants the assistant to preview and render a HyperFrames project without guessing commands
Teams rendering batches of videos from variables or in their own cloud

Install hyperframes-cli

Claude Code

Copy this prompt.

Install the hyperframes-cli skill in Claude Code. Run this command:

claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. The plugin bundles the full skill catalog and updates through Claude Code's plugin manager. The other two install the core four only. The four core skills work as one set: hyperframes holds the rules, hyperframes-cli the commands, hyperframes-registry the ready-made effects and media-use the media. Installing one alone leaves the others' hand-offs unanswered. Rendering needs Node.js 22+ and FFmpeg.

From the project README. Source.

What's in the skill

When it loads

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

Sections in SKILL.md

Commands by job
The loop
Edit the timeline
Project history
Render where
When a command fails
References

Key facts

Author: HeyGen (HyperFrames)
License: Apache-2.0
Last commit: Nov 2, 2026
Files it bundles: SKILL.md and 12 reference files (no scripts)
Needs: Node.js 22+ and FFmpeg
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn

What it includes

`init <dir>` makes a blank project; `capture <url>` pulls in a website
Creates a project folder, or captures a site as source material.
Runs code · Start
`info`, `compositions`, `timeline --json`, `docs <topic>`
Lists what a project contains and what plays when.
Runs code · Read a project
`lint` while writing, `check --json` as the gate
check runs lint, runtime, layout and contrast tests and prints a Fix: line for each failure.
Runs code · Check it
`snapshot`, `keyframes`, `compare`, `audio`
snapshot writes PNG frames the assistant reads to see the video.
Runs code · Look at it
`timeline move, trim, split, set, duplicate, delete, apply, undo`
Edits clips the way the HyperFrames desktop app does. Each run prints a receipt that `timeline undo` can reverse.
Runs code · Edit the timeline
`catalog`, `add`, `media-treatment`, `tts`, `transcribe`, `beats`
Points to the hyperframes-registry and media-use skills for these.
Runs code · Reuse and media
`preview`, `render`, `publish`, `cloud`, `lambda`, `cloudrun`
Render has draft, looks and delivery quality. Cloud, AWS Lambda and Google Cloud Run render options are covered in reference files.
Runs code · Preview, render, ship
`doctor`, `browser`, `upgrade`, `clean`, `feedback`
A table of symptoms and fixes, such as missing Chrome or a heavy page that times out. `feedback` sends a rating unless telemetry is off.
Runs code · Upkeep and failures

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

Cloud rendering leaves your machine
cloud, lambda and cloudrun render elsewhere, and the SKILL.md marks cloud render as a paid-plan path.
Feedback is sent after a render
After a verified render the skill sends one feedback rating unless telemetry is off.
skills.sh audits
Gen Agent Trust Hub pass, Socket pass, Snyk warn. skills.sh
Edits can be undone
timeline edits print a receipt that timeline undo reverts, and history undo reverts a turn's writes.

Technical details

Turning on read-only	Ask for read-only commands only: info, compositions, timeline --json, lint, check. Render, publish, cloud and timeline edits change files or send data.
Talks to	npm (to run npx hyperframes). HyperFrames cloud (cloud render, publish; hosts not named in SKILL.md). Feedback and usage reports unless telemetry is off
Sign-in and keys	Not stated in SKILL.md; cloud commands use a separate auth command.
Scopes	Runs npx hyperframes commands in your project Writes project files, snapshots under .hyperframes/ and rendered MP4s Starts a local preview server

Questions

What does hyperframes-cli do?

It teaches the assistant which npx hyperframes command to run for each job: scaffold, check, snapshot, edit the timeline, preview, render and publish. It also covers reading JSON output and fixing failed builds or renders.

How do I install hyperframes-cli?

Use the install box above. It installs the four core HyperFrames skills (hyperframes, hyperframes-cli, hyperframes-registry and media-use) together. HeyGen's README also documents npx hyperframes skills update, which installs the same four from the latest main branch.

What do I need installed first?

Node.js 22 or newer and FFmpeg. If Chrome is missing, npx hyperframes browser ensure sets it up, and doctor checks the setup.

Do I need the hyperframes skill too?

Yes, in practice. hyperframes-cli says how to run the tools. The hyperframes skill holds the rules for what a valid video file contains.

Is hyperframes-cli safe?

It is text instructions with no scripts, and Gen Agent Trust Hub and Socket pass it (Snyk warns). The commands it tells the assistant to run write files, render video and cloud, lambda and cloudrun render off your machine (the SKILL.md marks cloud render as a paid-plan path), so watch for cloud and publish steps.

Is this the same as the HyperFrames plugin?

The skill is one part of it. The HyperFrames plugin bundles all the skills for Claude Code. Install the skill alone if you only want this command reference.

Information

updated Nov 2, 2026

Repository: heygen-com/hyperframes
Folder: skills/hyperframes-cli

heygen-com/hyperframes skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

hyperframes README · github.com
skills CLI commands · github.com
hyperframes-cli SKILL.md · github.com
hyperframes-cli on skills.sh · skills.sh