Communitygithub.com

delorenj/skills

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

skills란 무엇인가요?

이 스킬은 HyperFrames 프레임워크용 레지스트리 시스템을 설명합니다. `hyperframes add <name>` 명령을 통해 재사용 가능한 블록(독립적인 서브-컴포지션)과 컴포넌트(이펙트 스니펫)를 설치하고 기존 호스트 컴포지션에 연결(wire)하는 방법을 안내합니다. 블록은 `compositions/` 디렉토리에 설치되며 `data-composition-src` 속성으로 호스트 컴포지션에 포함됩니다. 컴포넌트는 `compositions/components/` 디렉토리에 설치되며 HTML, CSS, JS 스니펫을 호스트 컴포지션에 직접 병합해야 합니다. 또한 설치 위치를 사용자 정의할 수 있는 `hyperframes.json` 설정과 레지스트리에서 사용 가능한 항목을 검색하는 `curl` 명령 예제를 제공합니다. 이 스킬은 HyperFrames를 사용하여 동적 비디오 컴포지션을 구축하는 개발자에게 필수적이며, CLI 출력을 해석하고 블록에 `data-composition-id`, `data-start`, `data-track-index`와 같은 필수 속성을 추가하는 방법을 설명합니다.

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

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

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

문서

HyperFrames 레지스트리

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

  • 블록(Blocks) — 독립형 서브-컴포지션(자체 디멘션, 지속 시간, 타임라인 포함). 호스트 컴포지션에서 data-composition-src를 통해 포함됩니다.
  • 컴포넌트(Components) — 이펙트 스니펫(자체 디멘션 없음). 호스트 컴포지션의 HTML에 직접 붙여넣기 됩니다.

이 스킬을 사용하는 경우

  • 사용자가 hyperframes add, "블록", "컴포넌트" 또는 hyperframes.json을 언급할 때
  • hyperframes add의 출력(파일 경로, 클립보드 스니펫)이 세션에 나타날 때
  • 설치된 항목을 기존 컴포지션에 연결(wire)해야 할 때
  • 레지스트리에서 사용 가능한 항목을 검색하고자 할 때

빠른 참조

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 14 individual skills — each has its own dedicated page.

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

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.

delorenj/skills

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 dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

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 (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

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.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

관련 스킬