Communitygithub.com

libz-renlab-ai/TeamBrain

HyperFrames 레지스트리에서 블록과 컴포넌트를 설치하고 HyperFrames 컴포지션에 연결합니다. hyperframes add 명령 실행, 블록 또는 컴포넌트 설치, 설치된 항목을 index.html에 연결, 또는 hyperframes.json 작업 시 사용됩니다. add 명령, 설치 위치, 블록 서브 컴포지션 연결, 컴포넌트 스니펫 병합, 레지스트리 검색을 다룹니다.

TeamBrain란 무엇인가요?

이 스킬은 HyperFrames 레지스트리 작업을 위한 종합 가이드입니다. `hyperframes add` CLI 명령을 사용하여 재사용 가능한 블록(독립 서브 컴포지션)과 컴포넌트(이펙트 스니펫)를 설치하는 방법을 설명합니다. 블록은 `data-composition-src` 속성을 통해 호스트 컴포지션에 연결되며, 컴포넌트는 HTML, CSS, JS 스니펫을 직접 병합하는 방식으로 통합됩니다. `hyperframes.json` 설정 파일을 통한 설치 경로 사용자 정의, 설치된 항목의 속성(예: `data-composition-id`, `data-start`) 구성, 그리고 레지스트리 매니페스트를 통한 항목 검색 방법을 상세히 다룹니다. 주로 Claude Code, Cursor, Codex 등 AI 코딩 에이전트가 HyperFrames 기반 프로젝트에서 작업할 때 유용합니다.

지원 대상~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> 명령으로 설치할 수 있는 재사용 가능한 블록과 컴포넌트를 제공합니다.

  • 블록 — 독립적인 서브 컴포지션 (자체 차원, 지속 시간, 타임라인 있음). 호스트 컴포지션에서 data-composition-src를 통해 포함됩니다.
  • 컴포넌트 — 효과 스니펫 (자체 차원 없음). 호스트 컴포지션의 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/headless)

설치 후 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에는 이름, 유형, 제목, 설명, 태그, 차원(블록만 해당), 지속 시간(블록만 해당), 파일 목록이 포함됩니다.

유형 및 태그별 필터링에 대한 자세한 내용은 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.

관련 스킬