Communitygithub.com

nateherkai/hyperframes-student-kit

規劃、撰寫、計時、設計樣式並驗證長篇談話型 HyperFrames 影片的動態圖像節拍。用於 Codex 被要求新增或改善視覺節拍、玻璃態下方三分之一處、皺紙全螢幕覆蓋、逐字稿同步提示、節奏覆蓋、YouTube 留存率圖形或現有 HyperFrames 影片專案中可渲染覆蓋層時。

hyperframes-student-kit 是什麼?

此技能專為 HyperFrames 影片專案中的 AI 代理(如 Codex)設計,用於將談話型影片與逐字稿轉換為一套有節奏的動態圖像,以支援旁白而不過度遮蓋講者。它基於詳細的 SKILL.md 文件,提供結構化的工作流程,包括第一遍覆蓋掃描、節奏類型決策(全螢幕皺紙 vs. 玻璃態下方三分之一處)、內容撰寫指引、視覺風格規範、計時方法以及驗證步驟。該技能支援 HyperFrames 生態系統,要求遵循特定實作規則(如 data-start 屬性、GSAP 時間軸),並提供實用的預設值(如節拍持續時間、閾值)以簡化開發流程。其主要目標是保持觀眾專注與參與,確保每個視覺節拍都有助於傳達影片中的關鍵概念、數據或對比,而非隨意填補空白。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 影片節拍

使用此技能將談話型影片與逐字稿轉換為一套有節奏的動態圖像,以支援旁白而不過度遮蓋講者。

核心目標

保持觀眾定向與參與。每個節拍都必須回答以下問題之一:

  • 觀眾應該記住什麼?
  • 哪個概念需要視覺結構?
  • 哪個統計數據、對比或轉折點值得強調?
  • 哪裡的節奏變得安靜到觀眾可能會分心?

不要僅僅因為存在空隙就添加圖形。只有在旁白包含一個主題、轉折、證明點或思維模型,且該部分能從視覺支援中受益時,才添加圖形。

第一遍

  1. 閱讀專案說明文件(AGENTS.md、本地技能文件以及專案專用筆記)。
  2. 檢查根合成、當前節拍排程、共用 CSS 以及逐字稿。
  3. 根據根 data-start / data-duration 條目或主 SHOW 陣列建立覆蓋地圖。
  4. 為任何請求的區域以及任何未覆蓋的空隙提取逐字稿區塊。
  5. 根據旁白、而非任意時間戳來識別主題跨度。
  6. 決定每個主題是否需要全螢幕紙張節拍、玻璃態下方三分之一處卡片,或無需新節拍。

使用快速的本地指令。偏好使用 rg、Select-String 以及小型 Node/PowerShell 逐字稿腳本。

節拍類型決策

使用全螢幕皺紙

當旁白達到一個重大的論點、列表、章節標記、引用或統計數據,且該內容應短暫成為整個畫面時,使用紙張接管。

好的用途:

  • 鉤子回報或「本影片內容」概述
  • 主要章節轉折
  • 重大統計數據或研究結果
  • 令人難忘的論點句子
  • 簡短引語或口頭禪
  • 需要觀眾停下來觀看的對比

規則:

  • 保持簡短,通常 4-12 秒。
  • 使用稀疏的黑色文字。
  • 僅讓真正的統計數字或一個極其重要的詞使用強調色。
  • 不要用紙張接管覆蓋長篇解釋。
  • 預設情況下,不要讓全螢幕文字顯得太花俏、巨大或過粗。

使用玻璃態下方三分之一處

當講者應該保持可見且圖形應支援當前想法時,使用玻璃下方三分之一處。

好的用途:

  • 解釋支架
  • 主題標籤
  • 方程式風格的思維模型
  • 小列表
  • 「這意味著什麼」的轉譯
  • 在長篇談話片段中填補節奏
  • 在縮短的全螢幕或分割畫面節拍之後的跟進卡片

規則:

  • 將下方三分之一處保持在下方三分之一處或下半部。
  • 避免遮蓋臉部。
  • 使用簡潔的文字:一個標題加上可選的簡短副標題,或一個 2-4 項的列表。
  • 偏好每個主題跨度使用一張卡片,而非許多短暫閃爍的小卡片。
  • 除非使用者要求變更設計,否則保留現有的玻璃卡片樣式。

節奏啟發式

針對長篇 YouTube 談話型影片:

  • 影片前期:避免超過 20-30 秒沒有視覺節拍。
  • 主要內容:避免超過 30-45 秒沒有節拍。
  • 密集解釋段落:大約每個主題跨度使用一個下方三分之一處,而非每個句子都使用。
  • 大型紙張接管應是偶爾的標點符號,而非預設選項。
  • 如果現有節拍因感覺太長而被手動縮短,請尊重該選擇,並在其後用一個新的較短卡片進行填充。

掃描排程時,請根據可見性排程報告真正的空隙,而非僅依據 DOM 順序。如果根時間軸使用 SHOW 陣列,那通常是權威的可見範圍。

計時方法

根據逐字稿主題為每個節拍計時:

  1. 找到主題開始的第一個詞或片語。
  2. 務必在該錨點之前 0.2-0.6 秒開始節拍。
  3. 保持節拍可見,直到主題結束或自然交接。
  4. 如果下一個節拍立即開始,請在它之前清除 0.1-0.5 秒,除非有意進行交接。
  5. 使子元素進入時間與口語片語匹配。

避免以下失敗模式:

  • 卡片出現在正確的主題上,但僅持續 5-8 秒,而講者卻繼續討論該主題 20-40 秒。

偏好:

  • 一張卡片存續於整個主題,如果旁白有所發展,在中途建立一個副標題或列表項。

內容撰寫

為一瞥理解而撰寫。觀眾應在不到一秒內理解卡片內容。

使用:

  • 簡短的名詞片語
  • 直接標籤
  • 每張卡片一個思維模型
  • 僅在有意義時使用數字
  • 在能澄清動作時使用動詞

避免:

  • 重複整個旁白
  • 長句
  • 模糊的宣傳語言
  • 太多強調的單詞
  • 在圖形內部解釋如何使用影片

良好範例:

瓶頸
實際工作流程中沒有足夠的 AI。
問題在於採用,而非天賦。
橋樑
技能 + 工作流程 = 節省 40 小時
本影片內容
-> 研究
-> 統計數據
-> 你可以走的路徑
-> 真正重要的是什麼

視覺樣式規則

首先遵循本地設計系統。針對此專案系列,使用:

  • 嚴肅的專業字體排印。
  • 紙張節拍使用黑色主要文字。
  • 強調藍色僅用於主要統計數字或少數強力詞。
  • 使用現有深色磨砂風格的玻璃卡片。
  • 不遮蓋講者臉部的下方三分之一處卡片。

對於紙張節拍:

  • 使用黑色來表示引導句、標籤、箭頭、來源、引用和輔助文字。
  • 保持字重克制。
  • 除非使用者明確要求,否則避免使用過大的趣味字體。
  • 使皺紙動作具有確定性。

對於玻璃卡片:

  • 重複使用 .glass-card dim lower-third 或最接近的現有類別。
  • 偏好底部居中位置。
  • 保持卡片緊湊。
  • 當概念具有結構性時,使用方程式/列表輔助工具。

HyperFrames 實作規則

遵循專案 AGENTS.md 和 HyperFrames lint 規則:

  • 每個安裝的計時元素都需要 data-start、data-duration 和 data-track-index。
  • 可見的計時根安裝元素應具有專案使用的預期剪輯/圖層類別。
  • 子合成應在 window.__timelines 上註冊一個暫停的 GSAP 時間軸。
  • 用 tl.set({}, {}, SLOT); 固定每個子合成時間軸。
  • 僅保留確定性邏輯。
  • 不要以可能凍結渲染的方式來動畫化影片元素尺寸或媒體屬性。
  • 編輯 HTML 後執行 npx hyperframes lint。

新增節拍時:

  1. 建立 compositions/beats/NNN-short-name.html。
  2. 在 index.html 中新增根安裝點。
  3. 如果存在主可見性排程,則新增或更新它。
  4. 使子合成的 SLOT 與安裝的持續時間匹配。
  5. 驗證沒有相同軌道的重疊,除非專案有意使用多個覆蓋軌道。

覆蓋掃描

編輯後,掃描主排程:

  • 按可見開始時間排序列表節拍。
  • 列印超過目標閾值的空隙。
  • 僅在逐字稿有可支援的概念時,才新增或重新計時節拍。

對於此專案模式,使用 30 秒作為嚴格掃描閾值,並使用 45 秒作為最大可接受的主體閾值。

驗證

完成前:

  1. 執行 HyperFrames linter。
  2. 修復所有錯誤。
  3. 如果警告已知且不構成阻塞,則單獨提及它們。
  4. 如果使用者要求準備渲染的輸出,則視情況進行渲染或煙霧測試渲染。
  5. 告知使用者確切的檔案路徑和變更的時間戳。

實用預設值

除非專案上下文另有說明,否則使用以下預設值:

  • 全螢幕紙張概述:8-10 秒。
  • 全螢幕紙張統計:5-8 秒。
  • 玻璃態下方三分之一處解釋:12-30 秒。
  • 長主題玻璃卡片:25-45 秒,帶有交錯的子元素。
  • 節拍開始前導:0.2-0.6 秒。
  • 空隙掃描閾值:30 秒。
  • 下方三分之一處寬度:約 68-72vw,最大約 1240-1280px。

保留什麼

保留在審查過程中發現的使用者品味決策:

  • 如果使用者說某個節拍太長,不要只為滿足通用覆蓋規則而恢復它。
  • 如果玻璃卡片樣式已獲批准,請重複使用它,而不是重新設計。
  • 如果字體排印已獲批准,請保持穩定,僅調整局部大小/粗細。
  • 如果講者的臉部很重要,請優先使用下方三分之一處卡片,而非螢幕中央卡片。

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

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.

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/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.

相關技能