Communitygithub.com

assafkip/claude-video-editor

HyperFrames 레지스트리를 통해 블록 및 컴포넌트를 설치하고 와이어링합니다. hyperframes add 명령 실행, 블록/컴포넌트 설치, 설치된 항목을 index.html에 연결, hyperframes.json 작업 시 사용하세요. add 명령, 설치 위치, 블록 서브-컴포지션 와이어링, 컴포넌트 스니펫 병합, 레지스트리 검색을 다룹니다.

claude-video-editor란 무엇인가요?

이 스킬은 HyperFrames 레지스트리 작업을 위한 전문 가이드입니다. `hyperframes add` CLI 명령을 통해 재사용 가능한 블록(독립적인 서브-컴포지션)과 컴포넌트(이펙트 스니펫)를 설치하고, 이를 호스트 컴포지션에 와이어링하는 방법을 설명합니다. 블록 와이어링 시 `data-composition-src`, `data-composition-id`, `data-start`, `data-track-index` 등의 필수 속성을 올바르게 설정하는 방법과, 컴포넌트의 HTML/CSS/JS를 기존 컴포지션에 병합하는 상세 절차를 제공합니다. 또한 `hyperframes.json` 설정 파일과 레지스트리 매니페스트를 통한 항목 검색 방법도 다룹니다. 주로 Claude Code와 같은 AI 에이전트가 비디오 편집 워크플로우에서 자동화된 블록/컴포넌트 설치 및 통합을 수행할 때 활용됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/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 9 individual skills — each has its own dedicated page.

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

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.

관련 스킬