Hyperframes CLI
coleam00/hyperframes-ai-video-generation
HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark.
HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade).
Install Hyperframes CLI
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/categories/development/hyperframes-cli .claude/skills/hyperframes-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .claude/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/categories/development/hyperframes-cli .agents/skills/hyperframes-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .agents/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/categories/development/hyperframes-cli .cursor/skills/hyperframes-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .cursor/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cosmicstack-labs/mercury-agent-skills.git --path categories/development/hyperframes-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/categories/development/hyperframes-cli .gemini/skills/hyperframes-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .gemini/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/categories/development/hyperframes-cli .github/skills/hyperframes-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .github/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cosmicstack-labs/mercury-agent-skills hyperframes-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/categories/development/hyperframes-cli .opencode/skills/hyperframes-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "hyperframes-cli" agent skill from https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/development/hyperframes-cli into .opencode/skills/hyperframes-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hyperframes-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
hyperframes-cli- GitHub stars
- 476
- Token cost
- ~1.4k tokens
- SKILL.md length
- 310 words
- Files
- 1
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade).
- Works in 6 steps: Scaffold — npx hyperframes init my-video → Write — author HTML composition (see the… → Lint — npx hyperframes lint → …
- Running any npx hyperframes command
- SKILL.md covers Workflow, Scaffolding, Linting and Visual Inspect, plus 5 more sections
- Calls npx
What it does
Hyperframes CLI is an agent skill from cosmicstack-labs/mercury-agent-skills. HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any npx hyperframes command or troubleshooting the build/render environment. For composition authoring see the hyperframes skill; for asset preprocessing (tts, transcribe, remove-background) see the hyperframes-media skill.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Media & Creative, covering Motion graphics, Linting and formatting and Project scaffolding. It works with HeyGen. The repository describes itself as: A curated registry of reusable Mercury Agent, Open Claw or Hermes Agent skills designed for real developer workflows, persistent memory, and token-efficient execution. The licence is MIT.
When your agent uses it
- Running any npx hyperframes command
- Troubleshooting the build/render environment
Example prompts
- “Use the hyperframes-cli skill to hyperframe CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload…”
- “/hyperframes-cli”
Requirements
- Node.js
- Docker
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Scaffold — npx hyperframes init my-video
- Write — author HTML composition (see the hyperframes skill)
- Lint — npx hyperframes lint
- Visual inspect — npx hyperframes inspect
- Preview — npx hyperframes preview
- Render — npx hyperframes render
What it can do on your machine
Read from SKILL.md and the folder at commit 30392fb. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Hyperframes CLI loads about 1.4k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 310 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from cosmicstack-labs/mercury-agent-skills at commit 30392fb, republished under its MIT licence (© cosmicstack-labs). 310 words, ~1,396 tokens.
Download SKILL.mdSave it as
.claude/skills/hyperframes-cli/SKILL.md (or your agent's skills folder).- name
- hyperframes-cli
- description
- HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any npx hyperframes command or troubleshooting the build/render environment. For composition authoring see the hyperframes skill; for asset preprocessing (tts, transcribe, remove-background) see the hyperframes-media skill.
- metadata.author
- cosmicstack-labs
- metadata.version
- 1.0.0
- metadata.category
- development
- metadata.tags
- hyperframes, cli, video-rendering, devops, preview, lint, render, ffmpeg
HyperFrames CLI — Dev Loop
Everything runs through npx hyperframes. Requires Node.js >= 22 and FFmpeg.
Workflow
- Scaffold —
npx hyperframes init my-video - Write — author HTML composition (see the
hyperframesskill) - Lint —
npx hyperframes lint - Visual inspect —
npx hyperframes inspect - Preview —
npx hyperframes preview - Render —
npx hyperframes render
Lint and inspect before preview. Render before delivery.
Scaffolding
npx hyperframes init my-video # interactive wizard
npx hyperframes init my-video --example warm-grain # pick a template
npx hyperframes init my-video --video clip.mp4 # with video file
npx hyperframes init my-video --audio track.mp3 # with audio file
npx hyperframes init my-video --example blank --tailwind # with Tailwind v4
npx hyperframes init my-video --non-interactive # skip prompts (CI/agents)Templates: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph
init creates the right file structure, copies media, transcribes audio with Whisper, and installs AI coding skills. Use it instead of creating files by hand.
Linting
npx hyperframes lint # current directory
npx hyperframes lint ./my-project # specific project
npx hyperframes lint --verbose # info-level findings
npx hyperframes lint --json # machine-readableLints index.html and all files in compositions/. Reports errors (must fix), warnings (should fix), and info (with --verbose).
Visual Inspect
npx hyperframes inspect # inspect layout over the timeline
npx hyperframes inspect ./my-project # specific project
npx hyperframes inspect --json # agent-readable findings
npx hyperframes inspect --samples 15 # denser timeline sweep
npx hyperframes inspect --at 1.5,4,7.25 # explicit hero-frame timestampsReports:
- Text extending outside visual containers/bubbles
- Text clipped by fixed-width/fixed-height boxes
- Text extending outside the composition canvas
- Children escaping clipping containers
Error: must fix before rendering. Warning: agent review. Run with --strict to fail on warnings too.
Mark elements with data-layout-allow-overflow (intentional entrance/exit overflow) or data-layout-ignore (decorative elements).
Previewing
npx hyperframes preview # serve current directory
npx hyperframes preview --port 4567 # custom port (default 3002)Hot-reloads on file changes. Opens the Studio in browser automatically.
When handing a project back, use the Studio URL: http://localhost:<port>/#project/<project-name>
Rendering
npx hyperframes render # standard MP4
npx hyperframes render --output final.mp4 # named output
npx hyperframes render --quality draft # fast iteration
npx hyperframes render --fps 60 --quality high # final delivery
npx hyperframes render --format webm # transparent WebM
npx hyperframes render --docker # byte-identical| Flag | Options | Default | Notes |
|---|---|---|---|
--output | path | renders/name_timestamp.mp4 | Output path |
--fps | 24, 30, 60 | 30 | 60fps doubles render time |
--quality | draft, standard, high | standard | draft for iterating |
--format | mp4, webm | mp4 | WebM supports transparency |
--workers | 1-8 or auto | auto | Each spawns Chrome |
--docker | flag | off | Reproducible output |
--gpu | flag | off | GPU-accelerated encoding |
--strict | flag | off | Fail on lint errors |
--strict-all | flag | off | Fail on errors AND warnings |
--variables | JSON object | — | Override composition variables |
--variables-file | path | — | JSON file with variables |
--strict-variables | flag | off | Fail on undeclared keys |
Quality guidance: draft while iterating, standard for review, high for final delivery.
Troubleshooting
npx hyperframes doctor # check environment (Chrome, FFmpeg, Node, memory)
npx hyperframes browser # manage bundled Chrome
npx hyperframes info # version and environment details
npx hyperframes upgrade # check for updatesRun doctor first if rendering fails.
Other Commands
npx hyperframes compositions # list compositions in project
npx hyperframes docs # open documentation
npx hyperframes benchmark . # benchmark render performanceRelated Skills
| Skill | Purpose |
|---|---|
hyperframes | Composition authoring (HTML, GSAP, captions, variables) |
hyperframes-media | Asset preprocessing (TTS, transcribe, background removal) |
© cosmicstack-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in categories/development/hyperframes-cli of cosmicstack-labs/mercury-agent-skills.
Open the folder on GitHubat commit 30392fb
Compare with similar skills
Hyperframes CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Hyperframes CLI this skillcosmicstack-labs/mercury-agent-skills | 476 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Hyperframes CLIcoleam00/hyperframes-ai-video-generation | 148 | — | ~1.6k | Automated safety check: Pass | None | |
| Hyperframes CLIOpenMinis/MinisSkills | 440 | — | ~3.5k | Automated safety check: Pass | MIT | |
| Hyperframes CLIboraoztunc/skills | 393 | 1 repos | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| Hyperframes CLInateherkai/hyperframes-student-kit | 1.2k | 3 repos | ~1.2k | Automated safety check: Pass | Custom licence | |
| Hyperframes Mediachmonitor/chmonitor | 298 | 1 repos | ~2.8k | Automated safety check: Notes | GPL-3.0 |
Similar skills
Hyperframes CLI
OpenMinis/MinisSkills
HyperFrames CLI and Minis rendering. An agent skill from OpenMinis/MinisSkills.
Hyperframes CLI
boraoztunc/skills
HyperFrames CLI dev loop — npx hyperframes for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade).
Hyperframes CLI
nateherkai/hyperframes-student-kit
HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark.
Hyperframes Media
chmonitor/chmonitor
Audio and media assets for HyperFrames compositions, produced by one shared audio engine (scripts/audio.mjs) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound…
Content To Video
architectds/modeldock
Turn arbitrary source content (README, article, story, slides, deck, data/report, product description, tutorial text, audio/transcript, or a bare topic) into a finished, high-quality MP4 video.
More from cosmicstack-labs/mercury-agent-skills
All 12 skills in this repoBefore You Build
cosmicstack-labs/mercury-agent-skills
Use this before implementing a product, feature, SaaS, AI app, or side project to score product risk and choose the smallest validation step.
Hyperframes Media
cosmicstack-labs/mercury-agent-skills
Asset preprocessing for HyperFrames compositions — local text-to-speech narration (Kokoro-82M, no API key), audio/video transcription (Whisper), and background removal for transparent overlays…
Agent Handoff Protocols
cosmicstack-labs/mercury-agent-skills
Design and implement agent-to-agent handoff protocols for multi-agent systems.
Agent Health Monitoring
cosmicstack-labs/mercury-agent-skills
Monitor AI agent health, detect anomalies, set up alerting, and maintain observability dashboards for production multi-agent systems.
Agent Task Delegation
cosmicstack-labs/mercury-agent-skills
Design and operate task delegation systems for multi-agent fleets.
Any2pdf
cosmicstack-labs/mercury-agent-skills
Convert Markdown to publication-quality PDF with reportlab — CJK/Latin mixed text, themes, cover pages, watermarks, callouts, formulas, and interactive theme selection
Related
Works with
Categories
Questions about Hyperframes CLI
What does Hyperframes CLI do?
HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade). Hyperframes CLI is an agent skill from cosmicstack-labs/mercury-agent-skills. HyperFrames CLI dev loop — project scaffolding, validation (lint/inspect), browser preview with live reload, MP4/WebM rendering, and environment troubleshooting (doctor, browser, info, upgrade).
When should I use Hyperframes CLI?
Hyperframes CLI fits situations like: running any npx hyperframes command; troubleshooting the build/render environment.
How do I install Hyperframes CLI in Claude Code?
Run `npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a claude-code`. Or copy the skill folder (categories/development/hyperframes-cli in cosmicstack-labs/mercury-agent-skills) into .claude/skills/hyperframes-cli in your project. Claude Code loads it when a task matches its description.
How do I install Hyperframes CLI in Codex?
Run `npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a codex`. Or copy the skill folder (categories/development/hyperframes-cli in cosmicstack-labs/mercury-agent-skills) into .agents/skills/hyperframes-cli in your project. Codex loads it when a task matches its description.
Can I use Hyperframes CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cosmicstack-labs/mercury-agent-skills --skill hyperframes-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hyperframes-cli, .gemini/skills/hyperframes-cli, .github/skills/hyperframes-cli and .opencode/skills/hyperframes-cli in your project.
What does Hyperframes CLI need to run?
Going by SKILL.md and its folder, Hyperframes CLI needs the command-line tools its instructions call (npx). Our summary lists: Node.js; Docker.
Does Hyperframes CLI access the network?
SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Hyperframes CLI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Hyperframes CLI use?
Hyperframes CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Hyperframes CLI use?
About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Hyperframes CLI?
Skills that share tags, products or a category with Hyperframes CLI: Hyperframes CLI (coleam00/hyperframes-ai-video-generation, 148 stars), Hyperframes CLI (OpenMinis/MinisSkills, 440 stars), Hyperframes CLI (boraoztunc/skills, 393 stars) and Hyperframes CLI (nateherkai/hyperframes-student-kit, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Hyperframes CLI?
cosmicstack-labs (a GitHub organization) maintains it in cosmicstack-labs/mercury-agent-skills, which has 476 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on August 25, 2026.
Source: cosmicstack-labs/mercury-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.