Communitygithub.com

libz-renlab-ai/TeamBrain

HyperFramesレジストリのブロックとコンポーネントをインストールし、既存のコンポジションに配線します。hyperframes addコマンドの実行時や、レジストリのアイテム発見時に使用します。

TeamBrain とは?

このスキルは、HyperFramesレジストリから再利用可能なブロック(独立したサブコンポジション)とコンポーネント(エフェクトスニペット)をインストールし、ホストコンポジションに配線するための手順を提供します。`hyperframes add`コマンドの使い方、インストール場所の設定、ブロックのサブコンポジション配線(data-composition-src属性を使用)、コンポーネントのHTML/CSS/JSスニペットのマージ方法をカバーしています。また、`hyperframes.json`によるパス設定や、レジストリ内のアイテムを発見する方法(curlコマンド)も説明します。このスキルは、HyperFramesを使用する開発者やAIエージェントが、レジストリのブロックやコンポーネントをプロジェクトに追加・統合する際のガイドとして機能します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HyperFrames レジストリ

レジストリは、hyperframes add <name> でインストール可能な再利用可能なブロックとコンポーネントを提供します。

  • ブロック — 独立したサブコンポジション(独自の寸法、duration、タイムラインを持つ)。ホストコンポジション内で 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 を参照してください。

ブロックの配線

ブロックは独立したコンポジションです — ホストの 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 には以下が含まれます:名前、タイプ、タイトル、説明、タグ、寸法(ブロックのみ)、duration(ブロックのみ)、ファイルリスト。

タイプとタグによるフィルタリングの詳細は 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.

関連スキル