Communitygithub.com

HyperFrames CLI

`npx hyperframes` 명령어를 사용하여 HyperFrames 프로젝트를 생성(init), 검증(lint, inspect), 미리보기(preview), 렌더링(render)하고 환경을 진단(doctor, browser, info, upgrade)하는 개발 루프를 제공합니다.

HyperFrames CLI란 무엇인가요?

이 스킬은 HyperFrames CLI의 모든 기능을 설명합니다. `npx hyperframes` 명령어를 통해 프로젝트 스캐폴딩(init), 린트(lint), 시각 검사(inspect), 미리보기(preview), 렌더링(render) 워크플로우를 지원합니다. Node.js >= 22와 FFmpeg가 필요하며, `doctor`, `browser`, `info`, `upgrade` 같은 문제 해결 명령어도 포함되어 있습니다. 자산 전처리 명령어(tts, transcribe, remove-background)는 별도의 `hyperframes-media` 스킬을 사용하세요. 이 스킬은 에이전트가 lint 검사, inspect 시각 피드백, 파라미터화된 렌더링 등을 수행할 때 유용하며, 특히 composition이 음성 풍선, 카드, 캡션 등 텍스트 오버플로우를 검사할 때 활용됩니다.

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

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

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

문서

HyperFrames CLI은(는) 무엇을 하나요?

모든 작업은 npx hyperframes로 실행합니다. Node.js >= 22와 FFmpeg가 필요합니다.

워크플로우

  1. 스캐폴딩 — npx hyperframes init my-video
  2. 작성 — HTML composition 작성 (hyperframes 스킬 참고)
  3. 린트 — npx hyperframes lint
  4. 시각 검사 — npx hyperframes inspect
  5. 미리보기 — npx hyperframes preview
  6. 렌더링 — npx hyperframes render

미리보기 전에 린트와 검사를 수행하세요. lint는 누락된 data-composition-id, 겹치는 트랙, 등록되지 않은 타임라인을 찾습니다. inspect는 headless Chrome에서 렌더링된 composition을 열고 타임라인을 탐색하며 말풍선/컨테이너 밖으로 나가거나 캔버스 밖으로 삐져나오는 텍스트를 보고합니다.

스캐폴딩

npx hyperframes init my-video                        # 대화형 마법사
npx hyperframes init my-video --example warm-grain   # 예제 선택
npx hyperframes init my-video --video clip.mp4        # 비디오 파일 포함
npx hyperframes init my-video --audio track.mp3       # 오디오 파일 포함
npx hyperframes init my-video --example blank --tailwind # Tailwind v4 브라우저 런타임 사용
npx hyperframes init my-video --non-interactive       # 프롬프트 생략 (CI/에이전트)

템플릿: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init은 올바른 파일 구조를 생성하고, 미디어를 복사하며, Whisper로 오디오를 전사하고, AI 코딩 스킬을 설치합니다. 수동으로 파일을 생성하는 대신 사용하세요.

--tailwind를 사용할 때는 클래스나 테마 토큰을 수정하기 전에 tailwind 스킬을 호출하세요. 스캐폴드는 Studio의 Tailwind v3 설정이 아닌 브라우저 런타임을 통해 Tailwind v4.2를 사용합니다.

린팅

npx hyperframes lint                  # 현재 디렉토리
npx hyperframes lint ./my-project     # 특정 프로젝트
npx hyperframes lint --verbose        # 정보 수준 결과
npx hyperframes lint --json           # 기계 판독 가능

index.html과 compositions/ 내 모든 파일을 린트합니다. 오류(수정 필수), 경고(수정 권장), 정보(--verbose 사용 시)를 보고합니다.

시각 검사

npx hyperframes inspect                 # 타임라인에 걸쳐 렌더된 레이아웃 검사
npx hyperframes inspect ./my-project    # 특정 프로젝트
npx hyperframes inspect --json          # 에이전트 판독 가능 결과
npx hyperframes inspect --samples 15    # 더 촘촘한 타임라인 스윕
npx hyperframes inspect --at 1.5,4,7.25 # 명시적 히어로 프레임 타임스탬프

lint와 validate 이후에 사용하며, 특히 말풍선, 카드, 캡션 또는 좁은 타이포그래피가 있는 composition에 유용합니다. 다음을 보고합니다:

  • 가장 가까운 시각적 컨테이너나 말풍선 밖으로 뻗어나간 텍스트
  • 자체 고정 너비/높이 상자에 의해 잘린 텍스트
  • composition 캔버스 밖으로 나간 텍스트
  • 클리핑 컨테이너를 탈출하는 자식 요소

오류는 렌더링 전에 수정해야 합니다. 경고는 에이전트 검토를 위해 표시됩니다. --strict를 추가하면 경고에도 실패합니다. 반복되는 정적 이슈는 기본적으로 접혀서 JSON 출력이 LLM 컨텍스트 윈도우에 적합하게 유지됩니다. 오버플로우가 entrance/exit 애니메이션을 위해 의도된 경우, 요소나 조상에 data-layout-allow-overflow를 표시하세요. 장식 요소가 감사되지 않아야 하는 경우 data-layout-ignore로 표시하세요.

npx hyperframes layout은 동일한 시각 검사 패스를 위한 호환성 별칭으로 계속 사용 가능합니다.

미리보기

npx hyperframes preview                   # 현재 디렉토리 서빙
npx hyperframes preview --port 4567       # 사용자 정의 포트 (기본값 3002)

파일 변경 시 핫 리로드됩니다. 브라우저에서 자동으로 스튜디오를 엽니다.

프로젝트를 사용자에게 반환할 때는 소스 index.html 경로가 아닌 스튜디오 프로젝트 URL을 사용하세요:

http://localhost:<port>/#project/<project-name>

미리보기 출력의 실제 포트와 프로젝트 디렉토리 이름을 사용하세요. 예를 들어, codex-openai-video 디렉토리에서 npx hyperframes preview --port 3017 실행 후 http://localhost:3017/#project/codex-openai-video를 보고하세요.

index.html은 소스 코드 컨텍스트로만 취급하세요. 구현 파일로 링크하는 것은 괜찮지만, 프로젝트나 미리보기 표면으로 레이블을 붙이지 마세요.

렌더링

npx hyperframes render                                # 표준 MP4
npx hyperframes render --output final.mp4             # 이름 지정 출력
npx hyperframes render --quality draft                # 빠른 반복
npx hyperframes render --fps 60 --quality high        # 최종 결과물
npx hyperframes render --format webm                  # 투명 WebM
npx hyperframes render --docker                       # 바이트 단위 동일
플래그옵션기본값참고
--output경로renders/name_timestamp.mp4출력 경로
--fps24, 30, 603060fps는 렌더 시간 두 배
--qualitydraft, standard, highstandarddraft는 반복 작업용
--formatmp4, webmmp4WebM은 투명도 지원
--workers1-8 또는 autoauto각각 Chrome 인스턴스 실행
--docker플래그off재현 가능한 출력
--gpu플래그offGPU 가속 인코딩
--strict플래그off린트 오류 시 실패
--strict-all플래그off오류 및 경고 시 실패
--variablesJSON 객체—data-composition-variables에 선언된 변수 값 오버라이드
--variables-file경로—변수 값을 담은 JSON 파일 (--variables 대안)
--strict-variables플래그off--variables에서 선언되지 않은 키나 타입 불일치 시 렌더링 실패

품질 가이드: 반복 작업 시 draft, 검토 시 standard, 최종 결과물 시 high.

매개변수화된 렌더: composition은 <html> 루트에 data-composition-variables 를 통해 변수를 선언합니다. 이는 스키마를 정의하는 JSON 선언 배열 ({id, type, label, default}) 입니다. 스크립트는 window.__hyperframes.getVariables()를 통해 해석된 값을 읽습니다. CLI --variables '{"title":"Q4 Report"}' 는 id를 키로 하는 JSON 객체로, 선언된 기본값을 한 번의 렌더에 대해 오버라이드합니다. 누락된 키는 기본값을 사용하므로 동일한 composition이 개발 미리보기와 프로덕션에서 변경 없이 실행됩니다. (서브 컴포지션 호스트는 data-variable-values 로 인스턴스별 오버라이드를 할 수 있습니다. 자세한 패턴은 hyperframes 스킬을 참고하세요.)

자산 전처리

npx hyperframes tts, transcribe, remove-background 명령어는 자산(내레이션 오디오, 단어 수준 전사, 투명 비디오)을 생성하여 composition에 배치합니다. 각 명령어는 첫 실행 시 자체 모델을 다운로드합니다. 음성 선택, Whisper 모델 규칙(.en이 비영어를 번역하는 문제), 출력 형식 선택(VP9 알파 WebM vs ProRes), TTS → 전사 → 캡션 체인에 대해서는 hyperframes-media 스킬을 호출하세요.

문제 해결

npx hyperframes doctor       # 환경 확인 (Chrome, FFmpeg, Node, 메모리)
npx hyperframes browser      # 번들된 Chrome 관리
npx hyperframes info         # 버전 및 환경 세부 정보
npx hyperframes upgrade      # 업데이트 확인

렌더링에 실패하면 먼저 doctor를 실행하세요. 일반적인 문제: FFmpeg 누락, Chrome 누락, 메모리 부족.

기타

npx hyperframes compositions   # 프로젝트 내 composition 목록
npx hyperframes docs           # 문서 열기
npx hyperframes benchmark .    # 렌더 성능 벤치마크

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

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

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

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.

관련 스킬