Communitygithub.com

HyperFrames CLI

HyperFrames CLI 도구 — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. 프로젝트 스캐폴딩, 컴포지션 린팅/검증, 스튜디오 미리보기, 비디오 렌더링, 오디오 텍스트 변환, TTS 생성, 또는 HyperFrames 환경 문제 해결 시 사용하세요.

HyperFrames CLI란 무엇인가요?

HyperFrames CLI는 Node.js >= 22 및 FFmpeg를 기반으로 실행되는 명령줄 도구로, `npx hyperframes` 명령어 하나로 모든 작업을 처리합니다. 이 스킬은 비디오 제작 워크플로우를 간소화하여 스캐폴딩(`init`), 린팅(`lint`), 미리보기(`preview`), 렌더링(`render`), 오디오/비디오 텍스트 변환(`transcribe`), 텍스트 음성 변환(`tts`), 환경 진단(`doctor`) 등 주요 단계를 지원합니다. 특히 `init` 명령어는 여러 템플릿을 제공하며, 비디오/오디오 파일 포함, Whisper 음성 인식, AI 코딩 스킬 설치까지 자동화합니다. 렌더링은 고품질 MP4/WebM 출력, GPU 가속, Docker 기반 재현 가능 렌더링 등 다양한 옵션을 제공하며, `lint` 명령어가 누락된 `data-composition-id`나 트랙 겹침 등을 사전에 발견하여 문제를 예방합니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 AI 에이전트 환경에서 프로젝트 설정부터 최종 비디오 제작까지 전체 과정을 안내합니다.

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

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

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

문서

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

모든 것은 npx hyperframes로 실행됩니다. Node.js >= 22 및 FFmpeg가 필요합니다.

워크플로우

  1. 스캐폴딩 — npx hyperframes init my-video
  2. 작성 — HTML 컴포지션 작성 (hyperframes 스킬 참조)
  3. 린팅 — npx hyperframes lint
  4. 미리보기 — npx hyperframes preview
  5. 렌더링 — npx hyperframes render

미리보기 전에 린팅을 수행하세요. 누락된 data-composition-id, 트랙 겹침, 등록되지 않은 타임라인을 찾아냅니다.

스캐폴딩

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 --non-interactive       # 프롬프트 건너뛰기 (CI/에이전트)

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

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

린팅

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

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

미리보기

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

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

렌더링

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는 렌더링 시간 2배
--qualitydraft, standard, highstandarddraft는 반복 작업용
--formatmp4, webmmp4WebM은 투명도 지원
--workers1-8 또는 autoauto각각 Chrome이 실행됨
--docker플래그off재현 가능 출력
--gpu플래그offGPU 가속 인코딩
--strict플래그off린트 오류 시 실패
--strict-all플래그off오류 및 경고 시 실패

품질 가이드: 반복 작업 시 draft, 검토 시 standard, 최종 전달 시 high를 사용하세요.

텍스트 변환

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 기존 자막 가져오기
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

텍스트 음성 변환

npx hyperframes tts "여기에 텍스트" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 모든 음성 목록 보기

문제 해결

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

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

기타

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

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

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.

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.

관련 스킬