Communitygithub.com

Sma1lboy/rove

HyperFrames 레지스트리에서 블록과 컴포넌트를 설치하고 연결합니다. `hyperframes add` 명령어를 사용할 때, 블록이나 컴포넌트를 설치하거나, 설치된 항목을 `index.html`에 연결하거나, `hyperframes.json`을 작업할 때 활용하세요. add 명령어, 설치 위치, 블록 서브 컴포지션 연결, 컴포넌트 스니펫 병합, 레지스트리 검색, 그리고 새 블록이나 컴포넌트를 작성하여 상위 저장소에 기여하는 과정(아이디어 → 스캐폴딩 → 검증 → PR)을 다룹니다.

rove란 무엇인가요?

이 스킬은 HyperFrames 레지스트리와 상호작용하여 재사용 가능한 블록과 컴포넌트를 설치하고 연결하는 방법을 설명합니다. 블록은 독립적인 서브 컴포지션으로 자체 차원, 지속 시간, 타임라인을 가지며 `data-composition-src`를 통해 호스트 컴포지션에 포함됩니다. 반면 컴포넌트는 효과 스니펫으로 자체 차원이 없으며 호스트 컴포지션의 HTML에 직접 붙여넣어집니다. `hyperframes add` 명령어를 사용하여 블록이나 컴포넌트를 설치할 수 있으며, 설치 후 CLI는 작성된 파일과 호스트 컴포지션에 붙여넣을 스니펫을 출력합니다. 블록 연결 시 `data-composition-id`, `data-start`, `data-track-index` 속성을 수동으로 추가해야 합니다. 또한, `hyperframes.json` 파일을 통해 설치 경로를 설정할 수 있고, `curl` 명령어로 레지스트리 매니페스트를 조회하여 사용 가능한 항목을 검색할 수 있습니다. 새로운 블록이나 컴포넌트를 기여하려면 `contributing.md`에 명시된 아이디어 → 스캐폴딩 → 구축 → 검증 → 미리보기 → PR 워크플로를 따라야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/hyperframes/registry

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HyperFrames 레지스트리

레지스트리는 hyperframes add <name>으로 설치할 수 있는 재사용 가능한 블록과 컴포넌트를 제공합니다.

  • 블록 — 독립적인 서브 컴포지션(자체 차원, 지속 시간, 타임라인). 호스트 컴포지션에서 data-composition-src를 통해 포함됩니다.
  • 컴포넌트 — 효과 스니펫(자체 차원 없음). 호스트 컴포지션의 HTML에 직접 붙여넣어집니다.

빠른 참조

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

유형 및 태그별 필터링에 대한 자세한 내용은 discovery.md를 참조하세요.

새 블록 또는 컴포넌트 기여

새로운 레지스트리 항목(자막 스타일, VFX 블록, 전환, 하단 써드, 또는 재사용 가능한 컴포넌트)을 작성하여 상위 저장소에 PR로 제출하려면(기존 항목을 설치하는 것이 아니라) contributing.md에 명시된 아이디어 → 스캐폴딩 → 구축 → 검증 → 미리보기 → PR 워크플로를 따르세요. 시작 템플릿(자막 / VFX / 컴포넌트 / registry-item.json)은 templates.md에 복사하여 붙여넣을 수 있습니다.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Sma1lboy/rove

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.\n

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

관련 스킬