# hyperframes-cli

hyperframes-cli guides the HyperFrames video build loop, from composition validation and timeline inspection to AWS Lambda rendering.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-cli/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/calesthio-hyperframes-cli

## What it does

This skill teaches the assistant how to drive the `npx hyperframes` workflow. It orchestrates scaffolding HTML video projects, catching missing timeline attributes, running contrast checks in headless Chrome, and spotting overflowing text layers before previewing in Studio.

The environment requires Node.js 22 or newer and a local FFmpeg installation. The CLI enforces strict agent behaviors: commands switch to non-interactive mode outside a TTY, JSON outputs mask home directories, and production renders pause for human approval instead of executing unattended.

## Requirements
- Works with: AWS

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill hyperframes-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hyperframes-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hyperframes-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill hyperframes-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hyperframes-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill hyperframes-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hyperframes-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/OpenMontage .agents/skills/hyperframes-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/hyperframes-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill hyperframes-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/hyperframes-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hyperframes-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-cli/SKILL.md

## When to use it
- Inspect HTML video compositions for timing and contrast bugs
- Render project sequences locally through FFmpeg
- Offload long video builds to AWS Lambda serverless jobs
- Audit text container overflow across animation timelines

## Example prompts
- Run hyperframes lint and inspect on the current video composition
- Set up AWS Lambda stack to render this multi-minute project
- Validate the composition contrast and check for runtime issues

## Similar
- [hyperframes](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes.md) — skill · 1600000 installs
- [hyperframes-registry](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-registry.md) — skill · 1400000 installs
- [hyperframes-video-composition](https://affpapa.org/en/nevibecode/skills/hyperframes-video-composition.md) — skill · 161 installs
- [aws-lambda-durable-functions](https://affpapa.org/en/nevibecode/skills/aws-lambda-durable-functions.md) — skill · 6600 installs
- [deploying-custom-domain-rest-api](https://affpapa.org/en/nevibecode/skills/deploying-custom-domain-rest-api.md) — skill · 5800 installs
- [aws-lambda-typescript-integration](https://affpapa.org/en/nevibecode/skills/aws-lambda-typescript-integration.md) — skill · 3800 installs

## Other versions with the same name
- [hyperframes-cli · heygen-com](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — 1700000 installs
- [hyperframes-cli · boraoztunc](https://affpapa.org/en/nevibecode/skills/boraoztunc-hyperframes-cli.md) — 216 installs
- [hyperframes-cli · coco-research](https://affpapa.org/en/nevibecode/skills/coco-research-hyperframes-cli.md) — ★ 328 repo stars

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
