Communitygithub.com

nateherkai/hyperframes-student-kit

安裝並將註冊表區塊與元件接入 HyperFrames 組合。當執行 hyperframes add、安裝區塊或元件、將安裝項目接入 index.html 或處理 hyperframes.json 時使用。涵蓋 add 指令、安裝位置、區塊子組合接入、元件片段合併以及註冊表探索。

hyperframes-student-kit 是什麼?

此技能專門用於 HyperFrames 註冊表,讓使用者能透過 `hyperframes add <name>` 指令安裝可複用的區塊(獨立子組合,擁有自己的尺寸、時長與時間軸)與元件(無獨立尺寸的效果片段,直接貼入主組合的 HTML 中)。它涵蓋安裝後的所有必要步驟:從 CLI 輸出中辨識檔案路徑與貼片段,到將區塊透過 `data-composition-src` 屬性接入主組合、為其附加 `data-composition-id`、`data-start` 和 `data-track-index` 等關鍵屬性,以及將元件的 HTML、CSS 與 JavaScript 手動合併到現有組合中。技能也支援透過curl探索註冊表內容,並引用 hyperframes.json 中的路徑設定與多份參考文件(install-locations.md、wiring-blocks.md、wiring-components.md、discovery.md)。它適用於 HyperFrames 生態系中的所有開發者,無論是在本機專案還是 CI/headless 環境使用 --no-clipboard 旗標時,都能提供一致的指引。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 註冊表

註冊表提供可透過 hyperframes add <name> 安裝的可重用區塊與元件。

  • 區塊 — 獨立的子組合(擁有自己的尺寸、時長、時間軸)。透過 data-composition-src 包含在主組合中。
  • 元件 — 效果片段(無獨立尺寸)。直接貼入主組合的 HTML 中。

何時使用此技能

  • 使用者提及 hyperframes add、「區塊」、「元件」或 hyperframes.json
  • 會話中出現 hyperframes add 的輸出(檔案路徑、剪貼簿片段)
  • 你需要將已安裝的項目接入現有組合
  • 你想探索註冊表中可用的項目

快速參考

hyperframes add data-chart              # 安裝區塊
hyperframes add grain-overlay           # 安裝元件
hyperframes add shimmer-sweep --dir .   # 指定特定專案
hyperframes add data-chart --json       # 機器可讀輸出
hyperframes add data-chart --no-clipboard  # 跳過剪貼簿(CI/無頭模式)

安裝後,CLI 會印出寫入了哪些檔案以及要貼入主組合的片段。該片段僅是起點 — 接入區塊時,你需要加上 data-composition-id(必須與區塊內部的組合 ID 相符)、data-start 和 data-track-index 屬性。

注意:hyperframes add 僅適用於區塊與元件。若要使用範例,請改用 hyperframes init <dir> --example <name>。

安裝位置

區塊預設安裝到 compositions/<name>.html。 元件預設安裝到 compositions/components/<name>.html。

這些路徑可在 hyperframes.json 中設定:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

詳見 install-locations.md。

接入區塊

區塊是獨立的組合 — 透過 data-composition-src 在你的主 index.html 中引入它們:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

關鍵屬性:

  • data-composition-src — 區塊 HTML 檔案的路徑
  • data-composition-id — 必須與區塊內部的 ID 相符
  • data-start — 區塊在主時間軸中出現的時間(秒)
  • data-duration — 區塊播放的持續時間
  • data-width / data-height — 區塊畫布尺寸
  • data-track-index — 圖層排序(數值越高越靠前)

詳見 wiring-blocks.md。

接入元件

元件是片段 — 將其 HTML 貼入組合的標記中、CSS 貼入樣式區塊、JS 貼入腳本(若有的話):

  1. 讀取已安裝的檔案(例如 compositions/components/grain-overlay.html)
  2. 將 HTML 元素複製到你的組合的 <div data-composition-id="..."> 中
  3. 將 <style> 區塊複製到組合的樣式中
  4. 將任意 <script> 內容複製到組合的腳本中(請放在時間軸程式碼之前)
  5. 若元件暴露了 GSAP 時間軸整合(請參見片段中的註解區塊),將那些呼叫加入你的時間軸

詳見 wiring-components.md。

探索

瀏覽可用項目:

# 讀取註冊表清單
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

每個項目的 registry-item.json 包含:名稱、類型、標題、描述、標籤、尺寸(僅區塊)、時長(僅區塊)以及檔案清單。

詳見 discovery.md 了解如何依類型和標籤過濾。

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

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.

相關技能