Communitygithub.com

libz-renlab-ai/TeamBrain

安装并将注册表块和组件集成到 HyperFrames 组合中。当执行 hyperframes add、安装块或组件、将已安装项接入 index.html 或处理 hyperframes.json 时使用。涵盖 add 命令、安装位置、块子组合接线、组件片段合并以及注册表发现。

TeamBrain 是什么?

该技能使 AI 代理能够管理 HyperFrames 注册表中的可复用块和组件。当用户提及 `hyperframes add`、"block"、"component" 或 `hyperframes.json` 时,或者当会话中出现 `hyperframes add` 的输出时,应激活此技能。它支持在 host 组合中通过 `data-composition-src` 将块作为独立子组合进行接线,以及将组件作为效果片段直接粘贴到 HTML 中。该技能提供安装路径配置(通过 `hyperframes.json` 自定义)、注册表发现(通过 curl 获取 registry.json)以及对关键属性(如 `data-composition-id`、`data-start` 和 `data-track-index`)的详细说明。它适用于任何支持 CLI 命令和文件操作的 AI 编码代理。

兼容平台~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 <name> 安装的可复用块和组件。

  • 块 — 独立的子组合(拥有自己的尺寸、时长和时间线)。通过 host 组合中的 data-composition-src 引入。
  • 组件 — 效果片段(没有自己的尺寸)。直接粘贴到 host 组合的 HTML 中。

何时使用此技能

  • 用户提及 hyperframes add、"block"、"component" 或 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 会输出写入的文件以及要粘贴到 host 组合中的片段。片段是起点 —— 接线块时,你需要添加 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。

接线块

块是独立组合 —— 通过 host 的 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 — 块在 host 时间线中出现的时间(秒)
  • 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.

相关技能