Communitygithub.com

libz-renlab-ai/TeamBrain

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

TeamBrain 是什麼?

這個技能專門用於 HyperFrames 平台,協助開發者從官方註冊中心安裝與接入可複用的區塊(Blocks)和元件(Components)。區塊是獨立的子組合,擁有自己的尺寸、時長和時間軸,透過 `data-composition-src` 屬性包含在主機組合中;元件則是效果片段,不具備獨立尺寸,直接貼入主機組合的 HTML 中。技能涵蓋 `hyperframes add` 指令的完整使用流程,包括指定安裝目錄、取得機器可讀輸出、跳過剪貼簿等選項。安裝完成後,CLI 會輸出寫入的檔案路徑及需要貼入 host 組合的片段,開發者需為區塊補上 `data-composition-id`、`data-start`、`data-track-index` 等屬性。此外,還提供探索註冊中心可用項目的方法(透過 curl 讀取 registry.json),以及各項目的詳細資訊(名稱、類型、標題、描述、標籤、尺寸與時長)。整體來說,這個技能大幅簡化了在 HyperFrames 專案中重用與整合預建模組的流程,適合需要快速組合多個獨立視覺與音訊效果的開發者使用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/hyperframes-registry

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 註冊中心

註冊中心提供可透過 hyperframes add <名稱> 安裝的可重用區塊和元件。

  • 區塊(Blocks) — 獨立的子組合(擁有自己的尺寸、時長、時間軸)。在主機組合中以 data-composition-src 屬性引入。
  • 元件(Components) — 效果片段(無獨立尺寸)。直接貼入主機組合的 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 <目錄> --example <名稱>。

安裝位置

區塊預設安裝至 compositions/<名稱>.html。 元件預設安裝至 compositions/components/<名稱>.html。

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

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

完整詳情請參閱 install-locations.md。

接線區塊

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

<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 5 individual skills — each has its own dedicated page.

libz-renlab-ai/TeamBrain

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.

libz-renlab-ai/TeamBrain

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

libz-renlab-ai/TeamBrain

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames — for example "port my Remotion project to HyperFrames", "convert this Remotion code to HyperFrames", "migrate from Remotion", "translate this Remotion comp", or "rewrite this as HyperFrames HTML". Do NOT use when (a) the user is authoring a NEW HyperFrames composition, even if they have or are A/B-testing a similar Remotion video; (b) the user mentions Remotion in passing without asking for migration; (c) the user shares Remotion code as reference material rather than asking for a translation; (d) the user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build. When in doubt, default to authoring a native HyperFrames composition with the `hyperframes` skill instead. Skill detects unsupported patterns (use...

libz-renlab-ai/TeamBrain

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

libz-renlab-ai/TeamBrain

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

相關技能