Communitygithub.com

nateherkai/hyperframes-student-kit

레지스트리 블록 및 컴포넌트를 설치하고 HyperFrames 구성에 연결합니다. `hyperframes add` 실행, 블록/컴포넌트 설치, 설치된 항목을 index.html에 연결하거나 hyperframes.json 작업 시 사용하세요. add 명령어, 설치 위치, 블록 하위 구성 연결, 컴포넌트 스니펫 병합, 레지스트리 탐색을 다룹니다.

hyperframes-student-kit란 무엇인가요?

이 스킬은 HyperFrames 프레임워크에서 재사용 가능한 시각적 블록과 효과 컴포넌트를 설치하고 연결하는 전 과정을 안내합니다. `hyperframes add <name>` 명령어로 설치된 블록(독립적인 하위 구성)은 `data-composition-src` 속성을 통해 호스트 구성에 삽입되며, 컴포넌트(이펙트 스니펫)는 HTML/CSS/JS 코드를 직접 병합하는 방식으로 동작합니다. Claude Code, Cursor, Codex 등 AI 에이전트가 사용자의 의도를 파악하여 `hyperframes add` 실행 결과를 해석하고, 설치된 블록에 `data-composition-id`, `data-start`, `data-track-index` 등의 필수 속성을 올바르게 추가하도록 돕습니다. 또한 `hyperframes.json`의 경로 설정, 레지스트리 탐색, CI/헤드리스 환경에서의 `--no-clipboard` 플래그 사용법까지 포괄하여 개발자와 AI 에이전트 모두가 HyperFrames 구성을 효율적으로 확장할 수 있게 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-registry

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

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

문서

HyperFrames 레지스트리

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

  • 블록 — 독립적인 하위 구성(자체 크기, 지속 시간, 타임라인을 가집니다). 호스트 구성에서 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에는 이름, 유형, 제목, 설명, 태그, 크기(블록만), 지속 시간(블록만), 파일 목록이 포함되어 있습니다.

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

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

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

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

관련 스킬