herk-edit-kit README

The project's README from github.com/nateherkai/herk-edit-kit. As one markdown file: README.md.

HyperFrames Student Kit

Nate Herk's reusable video-editing kit for Codex and Claude Code. Bring your own footage. Cut dead air, review mistakes, plan the story, and build motion graphics with HyperFrames and GSAP.

Examples

Four finished videos made with this kit.

YouTube motion showreel

Made with the motion-showreel skill: 15 seconds, 1920x1080, 60fps, cut to a 129 BPM grid. The red scrubber dot travels through seven craft chapters and lands as the play button in the logo.

https://github.com/user-attachments/assets/056b46e9-7379-4e71-b825-20fb9f8e9555

The three short-form videos below were created by Nate. Press Play on any video to watch it here in the README.

Curiosity reel: unlock your project

https://github.com/user-attachments/assets/920cc3b7-6ef0-4324-aa98-870c1c2a07c5

Curiosity reel: build a better AI system

https://github.com/user-attachments/assets/ba468302-fe07-4e4c-949b-68951dd84625

AIS Live ad

https://github.com/user-attachments/assets/4ad48761-d14c-407a-9dec-1b76a9afb04a

What's included

Tools and optional services

Nate uses ElevenLabs Scribe to transcribe and Kie.ai to generate videos and image assets. Bring your own API keys and credits when using those services. You can ask the assistant to use OpenAI Whisper or local Whisper instead, or supply an existing word-level transcript. Generated assets are optional.

The local starter needs no paid transcription or generation API. See the tools, accounts, and API-key guide for required tools, optional services, setup details, and prompts you can copy.

Install

Install Node.js 22 or newer, Git, FFmpeg (including ffprobe), and Chrome or Chromium. Make node, ffmpeg, and ffprobe available in your terminal. Then run these commands in PowerShell, macOS Terminal, or a Linux shell:

git clone https://github.com/nateherkai/hyperframes-student-kit.git
cd hyperframes-student-kit
npm ci
npm run setup
npm test

Setup checks the tools and creates .env only if it is absent. Add only the keys for services you choose. The included transcription helper uses ElevenLabs; Whisper and Kie.ai integrations need the setup described in the tools guide. Setup and troubleshooting.

Render your first example

npm run demo
cd video-projects/demo
npx hyperframes lint
npx hyperframes preview

Scrub the eight-second animation in Studio. After reviewing it, stop the preview with Ctrl+C, then render:

npx hyperframes render --quality draft --output renders/demo.mp4

The demo uses local GSAP. HyperFrames may download and cache its font substitutions on the first render. It has no voiceover. The separate synthetic transcript exercises the cutting tools; it is fictional test data, not a transcript of the title animation.

Edit your footage

Open this repository folder in Codex or Claude Code and say:

Use edit-video to edit my recording at [local path]. Keep my examples and core lessons. Tighten dead air, show me the proposed mistake cuts, and use the dark graph-paper style with occasional glass cards. Produce a reviewed draft.

Codex: $edit-video. Claude Code: /edit-video. For a single operation use cut-silences, cut-mistakes, video-storytelling, or style-library. See the step-by-step workflow, prompt recipes, and storytelling workbook.

Create a reel or YouTube Short

Use short-form-edit to turn my recording at [local path] into a 9:16 reel. Build a truthful hook and payoff, preserve my meaning, tighten mistakes, and add precise captions, purposeful moving footage, and sound design. Prepare a draft for review. Use my existing footage before proposing generated assets.

Codex: $short-form-edit. Claude Code: /short-form-edit. The skill includes planning references and validators for caption timing, source mapping, scene coverage, and footage reuse. It is an agent-guided workflow; review the actual motion and audio before publishing. Short-form walkthrough and validation commands.

Make a motion-design showreel

Use motion-showreel to make a 15-second showreel for [brand]. Study my reference reel at [local path] if I give one. Pick one motif that transforms through every chapter, cut on the music's beat grid, and end on the logo. Show me the storyboard and beat sheet before building, and confirm before any paid music or asset generation.

Codex: $motion-showreel. Claude Code: /motion-showreel. The skill includes a measured breakdown of the reel it was built from, a chapter technique library, a HUD template, and Node tools to analyze a reference video, measure a music take's beat grid, splice it onto the cut grid, and premix sound effects.

Existing examples and migration

This is the main student-kit repository. The newer video-pipeline kit has been merged here with both Git histories preserved. The original 12 projects remain in video-projects/, alongside the original shared brand examples and the make-a-video, short-form-video, and website-to-hyperframes skills. Use short-form-edit for new reels; short-form-video documents the older May Shorts compositions. Migration and compatibility notes.

Explore and customize

Resource Start here
Shared agent instructions AGENTS.md
Motion and transition vocabulary MOTION_PHILOSOPHY.md
Card library and design tokens Library guide
Searchable card metadata registry.json
Whole-scene templates Template guide
Codex setup and mirroring .codex/README.md
Release checks and limits Verification
Third-party resources Notices

The cards are reusable draft assets. Test the cards you choose with your text and footage. Library templates may load GSAP and Google Fonts from their public CDNs; localize these dependencies when assembling a final project.

The three showcase videos were explicitly supplied for public sharing. No other private recordings, transcripts, credentials, or private workspace settings were imported. Previously public examples remain in the repository. New folders under video-projects/ and raw-media/ are ignored automatically; files already tracked by Git remain tracked. Create a new project for your own footage.

herk-edit-kit (nateherkai/herk-edit-kit)

Searching Database…

这是什么?HyperFrames Student Kit 是 Nate Herk 的可复用视频剪辑套件,可接入 Codex 和 Claude Code,让它们获得剪掉冷场、发现问题、加字幕以及用你自己的素材制作 GSAP 动效图形等技能。
这是一个独立的视频编辑器,还是要通过 Codex/Claude Code 运行的东西?它不是独立的编辑器——它是为两个助手各自镜像配置的 15 个技能(附带辅助脚本和参考资料),通过 /edit-video 或 $short-form-edit 这类聊天命令调用,驱动 FFmpeg 剪辑和 GSAP 动效图形。
怎么把它跑起来?安装 Node.js 22 或更新版本、Git、FFmpeg(含 ffprobe)以及 Chrome 或 Chromium,然后在 PowerShell、macOS 终端或 Linux shell 中运行安装命令,它们会检查你的工具并创建 .env 文件。
使用它需要付费的 API 密钥吗?只有可选的云服务才需要:用于转写的 ElevenLabs Scribe 和用于生成视频/图片素材的 Kie.ai。你可以换成 OpenAI 或本地 Whisper,自己提供转写稿,或使用合成的入门示例——这些完全不需要 API 密钥。
它会自动完成剪辑并发布吗?不会——short-form-edit 和 motion-showreel 这类技能会产出供审阅的草稿,先给你看分镜、剪辑或字幕;这是一个由智能体引导的工作流,发布前你必须亲自检查实际的动效和音频。
我可以在哪些操作系统上运行它?它跨平台工作——安装命令可在 PowerShell、macOS 终端或 Linux shell 中运行。
那 406 张动效图形卡片是做什么用的?它们是两种风格(深色方格纸和玻璃弹出式)的动画场景卡片草稿,带有 manifest、CSS token 和可编辑插槽,方便你放入自己的文字和素材。
motion-showreel 技能实际会做出什么?给定一个品牌和可选的参考片,它会选定一个主题母题,用 Node 工具分析音乐的节拍网格,然后组装一段以你的 logo 收尾的 15 秒集锦,背后有 HUD 模板和分章技法库支撑。
为什么用 GSAP 而不是时间线编辑器来做动效图形?HyperFrames 用本地 GSAP 把场景渲染成动画网页,让智能体用代码编写剪辑、字幕和转场,而不是在 GUI 时间线里拖拽片段。
原来的学生套件项目后来怎么样了?12 个原始教学项目保留在 video-projects/ 目录下,较新的 video-pipeline 套件已合并进这个仓库,两边的 Git 历史都完整保留。
Creator
nateherkai
Size
449.3 MB
Stars
1.8K
Updated
CommitOct 14
Age
6mo
Commits · 90 Days