coltonjosephdean-rgbcoltonjosephdean-rgb/Hyperframes-colton.ai.dean/.claude/skills/hyperframes-cli/SKILL.md

hyperframes-cli

Skill19 starsChanged 5 months agoMITView on GitHub

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

0
Common
Most of the 41 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Run doctor first if rendering fails.
line 106

“Common” is measured: kept by at least 6 in 10 of the 41 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

HyperFrames CLI

Everything runs through npx hyperframes. Requires Node.js >= 22 and FFmpeg.

Workflow

Scaffold — npx hyperframes init my-video
Write — author HTML composition (see the hyperframes skill)
Lint — npx hyperframes lint
Preview — npx hyperframes preview
Render — npx hyperframes render

Lint before preview — catches missing data-composition-id, overlapping tracks, unregistered timelines.

Scaffolding

npx hyperframes init my-video                        # interactive wizard
npx hyperframes init my-video --example warm-grain   # pick an example
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 --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-readable

Lints index.html and all files in compositions/. Reports errors (must fix), warnings (should fix), and info (with --verbose).

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 your browser automatically.

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

Quality guidance: draft while iterating, standard for review, high for final delivery.

Transcription

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # import existing
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Text-to-Speech

npx hyperframes tts "Text here" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # show all voices

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 updates

Run doctor first if rendering fails. Common issues: missing FFmpeg, missing Chrome, low memory.

Other

npx hyperframes compositions   # list compositions in project
npx hyperframes docs           # open documentation
npx hyperframes benchmark .    # benchmark render performance

Download now (ZIP)

Other versions52 projects use a version of this.
Word for word · 9
nateherkai/hyperframes-student-kit★ 2.2k100% same
nateherkai/herk-edit-kit★ 1.5k100% same
nateherkai/hyperframes-video-pipeline★ 21100% same
assafkip/claude-video-editor★ 17100% same
coopersimson96/ai-content-system★ 17100% same
tony-hoang-ai-automation/mkt-skills★ 4100% same
F0rger123/claude-video-editing-god-mode★ 1100% same
chriswestt/claude-skills★ 0100% same
Samueladewole/claude-skills★ 0100% same
Edited · 18
openai/plugins★ 7.4k59% same
OpenMinis/MinisSkills★ 58427% same
boraoztunc/skills★ 33737% same
notivn/AIEV★ 132100% same
itgoyo/hermes-skills★ 5376% same
anton-abyzov/vskill★ 4837% same
delorenj/skills★ 1837% same
hoanghd218/claude-code-2-days★ 837% same
NexumAI-online/skills-edicion★ 412% same
dqtx760/skills-manage★ 259% same
8 more not listed
Wrote their own version · 25
heygen-com/hyperframes★ 77ksame name
calesthio/OpenMontage★ 74ksame name
EvovexAI/EvoFlow★ 572same name
langchain-ai/design-agent★ 535same name
edenfunf/reelmimic★ 311same name
duyet/clickhouse-monitoring★ 305same name
PinkR1ver/vibe-roast★ 49same name
STARDUSTLC666/dsh-hyperframes★ 24same name
tuan3w/herdr-mobile★ 22same name
Jakeschincariol/video-production-skills★ 15same name
15 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use oversized-cursor, cut-mistakes and 10 more.
Other files people use alongside this one.
- ElyzeSolutionsSkill
  oversized-cursor
  House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.
  Also in 5 projects that use this
- nateherkaiSkill
  cut-mistakes
  Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.
  Also in 5 projects that use this
- nateherkaiSkill
  cut-silences
  Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.
  Also in 5 projects that use this
- LangChainSkill
  faceless-explainer
  Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.
  Also in 15 projects that use this
- LangChainSkill
  hyperframes-creative
  Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.
  Also in 22 projects that use this
- anton-abyzovSkill
  hyperframes-media
  Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.
  Also in 13 projects that use this
- +2 more from nateherkai
- +4 more from langchain-ai
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- feedbackSkill
- gsapSkill
- hyperframes-registrySkill
- hyperframesSkill
- make-a-videoSkill
- setupSkill
- short-form-videoSkill
- study-creatorSkill
- website-to-hyperframesSkill

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

HyperFrames CLI

Workflow

Scaffolding

Linting

Previewing

Rendering

Transcription

Text-to-Speech

Troubleshooting

Other

Word for word · 9

Edited · 18

Wrote their own version · 25

oversized-cursor

cut-mistakes

cut-silences

faceless-explainer

hyperframes-creative

hyperframes-media

Does it work?

No reviews yet

Your trail

Now do this for your own.