Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFrames CLI 工具 — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark。用於搭建專案、檢查或驗證組合、在工作室預覽、渲染影片、轉錄音訊、生成 TTS 或排除 HyperFrames 環境問題。

hyperframes-student-kit 是什麼?

HyperFrames CLI 是一個專為 HyperFrames 學生套件設計的命令列工具,透過 `npx hyperframes` 執行,需 Node.js >= 22 與 FFmpeg。它支援完整的影片專案工作流程,包括:使用 `init` 命令從多種範本(如 blank, warm-grain, play-mode 等)初始化專案結構、複製媒體檔案、以 Whisper 轉錄音訊並安裝 AI 編碼技能;使用 `lint` 檢查 `index.html` 與 `compositions/` 中的文件,報告錯誤與警告;`preview` 提供即時重新載入的瀏覽器預覽;`render` 支援多種品質與格式(MP4, WebM),並可選擇 Docker 以獲得可重現的輸出。此外,還有 `transcribe`、`tts`、`doctor`、`browser`、`info`、`upgrade` 等命令協助轉錄、文字轉語音、環境診斷與更新。這個工具適合希望快速建立、迭代與產出高品質影片的自動化開發者或 AI 代理程式使用。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-cli

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HyperFrames CLI

所有操作皆透過 npx hyperframes 執行。需要 Node.js >= 22 與 FFmpeg。

工作流程

  1. 建立專案 — npx hyperframes init my-video
  2. 撰寫 — 編寫 HTML 組合(請參閱 hyperframes 技能)
  3. 檢查 — npx hyperframes lint
  4. 預覽 — npx hyperframes preview
  5. 渲染 — npx hyperframes render

在預覽前先檢查 — 可捕捉缺少的 data-composition-id、重疊的軌道、未註冊的時間軸。

建立專案

npx hyperframes init my-video                        # 互動式精靈
npx hyperframes init my-video --example warm-grain   # 選擇範例
npx hyperframes init my-video --video clip.mp4        # 搭配影片檔案
npx hyperframes init my-video --audio track.mp3       # 搭配音訊檔案
npx hyperframes init my-video --non-interactive       # 略過提示(CI/代理程式)

範本:blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph。

init 會建立正確的檔案結構、複製媒體、以 Whisper 轉錄音訊,並安裝 AI 編碼技能。請優先使用此命令,而非手動建立檔案。

檢查

npx hyperframes lint                  # 目前目錄
npx hyperframes lint ./my-project     # 指定專案
npx hyperframes lint --verbose        # 資訊層級的發現
npx hyperframes lint --json           # 機器可讀格式

檢查 index.html 與 compositions/ 中的所有檔案。回報錯誤(必須修復)、警告(建議修復)以及資訊(需搭配 --verbose)。

預覽

npx hyperframes preview                   # 提供目前目錄
npx hyperframes preview --port 4567       # 自訂連接埠(預設 3002)

檔案變更時自動重新載入。會自動在瀏覽器中開啟工作室。

渲染

npx hyperframes render                                # 標準 MP4
npx hyperframes render --output final.mp4             # 指定輸出檔名
npx hyperframes render --quality draft                # 快速疊代
npx hyperframes render --fps 60 --quality high        # 最終交付
npx hyperframes render --format webm                  # 透明背景 WebM
npx hyperframes render --docker                       # 位元組一致
旗標選項預設值備註
--output路徑renders/名稱_時間戳.mp4輸出路徑
--fps24, 30, 603060fps 會加倍渲染時間
--qualitydraft, standard, highstandarddraft 用於疊代
--formatmp4, webmmp4WebM 支援透明背景
--workers1-8 或 autoauto每個 worker 會啟動 Chrome
--docker旗標off可重現的輸出
--gpu旗標offGPU 加速編碼
--strict旗標off檢查錯誤時失敗
--strict-all旗標off檢查錯誤與警告時失敗

品質建議: 疊代時使用 draft,審查時使用 standard,最終交付時使用 high。

轉錄

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 匯入現有檔案
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

文字轉語音

npx hyperframes tts "此處文字" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 顯示所有語音

疑難排解

npx hyperframes doctor       # 檢查環境(Chrome, FFmpeg, Node, 記憶體)
npx hyperframes browser      # 管理內建 Chrome
npx hyperframes info         # 版本與環境詳細資訊
npx hyperframes upgrade      # 檢查更新

如果渲染失敗,請先執行 doctor。常見問題:缺少 FFmpeg、缺少 Chrome、記憶體不足。

其他

npx hyperframes compositions   # 列出專案中的組合
npx hyperframes docs           # 開啟文件
npx hyperframes benchmark .    # 基準測試渲染效能

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

相關技能