Communitygithub.com

johnnyjclin/video-producer

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

video-producer란 무엇인가요?

이 스킬은 HyperFrames CLI를 통해 비디오 제작 전 과정을 자동화하는 AI 에이전트 도구입니다. 사용자는 `npx hyperframes init`으로 프로젝트를 빠르게 스캐폴딩하고, `lint`와 `validate`로 정적/런타임 문제를 사전에 발견한 후 `preview`로 실시간 미리보기를 거쳐 `render`로 최종 비디오를 출력할 수 있습니다. 특히 `validate`는 실제 브라우저에서 컴포지션을 렌더링하여 WCAG 대비, 오버레이, 자산 누락 등 `lint`가 잡지 못하는 시각적/런타임 오류를 검출합니다. 지원되는 플랫폼은 Claude Code, Cursor, Codex 등이며, Node.js >= 22와 FFmpeg에 의존합니다. 이 스킬은 `npx hyperframes` 명령어 체계를 기반으로 작동하며, 개발자와 AI 에이전트 모두 반복적인 비디오 제작 파이프라인을 최소한의 명령어로 제어할 수 있게 해줍니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/johnnyjclin/video-producer/tree/HEAD/.claude/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 validate (브라우저 기반 런타임 검사 + 대비 감사)
  5. 미리보기 — npx hyperframes preview
  6. 렌더링 — npx hyperframes render

린트는 정적 문제(data-composition-id 누락, 트랙 중복, 등록되지 않은 타임라인)를 잡습니다. 검증은 실제 브라우저에서 일시 중지된 컴포지션을 탐색하여 런타임/시각적 문제(대비, 깨진 오버레이, 누락된 자산)를 찾습니다. 렌더 전에 두 검사를 모두 실행하세요.

검증

npx hyperframes validate                 # 전체 검증 (정적 + 대비 + 계약)
npx hyperframes validate --no-contrast   # 빠른 반복 시 WCAG 대비 감사 건너뛰기
npx hyperframes validate --json          # 기계 판독 가능 출력

검증은 일시 중지된 컴포지션의 여러 타임스탬프로 이동하여 페이지를 스크린샷하고, 모든 텍스트 요소 뒤의 픽셀을 샘플링하여 WCAG 대비 비율을 계산하며, 런타임 계약(window.__timelines 등록, class="clip" 존재, 유효한 data-* 속성)을 확인합니다. 모든 렌더 전에 실행하세요. 비용이 저렴하고 린트가 감지하지 못하는 문제를 찾아냅니다.

스캐폴딩

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는 렌더 시간 두 배
--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 .    # 렌더 성능 벤치마크

관련 스킬