Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI 개발 루프 — `npx hyperframes`를 사용한 스캐폴딩(init), 검증(lint, inspect), 미리보기, 렌더링 및 환경 문제 해결(doctor, browser, info, upgrade)을 지원합니다. 이 명령어를 실행하거나 HyperFrames 빌드/렌더 환경을 문제 해결할 때 사용하세요. 자산 전처리 명령어(`tts`, `transcribe`, `remove-background`)는 `hyperframes-media` 스킬을 대신 호출하세요.

Tony-Claude-Code-Skills란 무엇인가요?

이 스킬은 HyperFrames CLI의 모든 개발 루프 명령어를 중앙에서 관리합니다. `npx hyperframes init`으로 비디오 프로젝트를 스캐폴딩하고, `lint`와 `inspect`로 구성의 오류와 시각적 문제를 검사하며, `preview`로 실시간 미리보기를 제공하고, `render`로 최종 MP4/WebM을 출력합니다. Node.js >= 22와 FFmpeg가 필요하며, `doctor`, `browser`, `info`, `upgrade` 명령어로 환경 문제를 진단하고 해결합니다. 주로 Cursor, Claude Code, Codex 같은 AI 에이전트 환경에서 사용되며, 사용자가 비디오 제작 워크플로우를 실행하거나 문제를 겪을 때 자동으로 이 스킬을 참조하여 올바른 명령어와 파라미터를 제시합니다. 자산 전처리(tts, transcribe, remove-background)는 `hyperframes-media` 스킬로 분리되어 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-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 inspect
  5. 미리보기 — npx hyperframes preview
  6. 렌더링 — npx hyperframes render

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

스캐폴딩

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 스킬을 호출하세요. 스캐폴드는 브라우저 런타임을 통해 Tailwind v4.2를 사용하며, Studio의 Tailwind v3 설정을 사용하지 않습니다.

린팅

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 이후, 특히 말풍선, 카드, 자막 또는 조밀한 타이포그래피가 포함된 구성에서 이 명령어를 사용하세요. 다음을 보고합니다:

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

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

npx hyperframes layout은 동일한 시각적 검사 패스를 위한 호환성 별칭으로 계속 사용할 수 있습니다.

미리보기

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

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

프로젝트를 사용자에게 돌려줄 때는 소스 index.html 경로가 아닌 Studio 프로젝트 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, highstandard반복 시 draft 사용
--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를 사용하세요.

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

자산 전처리

npx hyperframes tts, transcribe, remove-background는 나레이션 오디오, 단어 수준 전사, 투명 비디오 등 구성을 위해 생성된 자산을 만듭니다. 각 명령어는 첫 실행 시 자체 모델을 다운로드합니다. 음성 선택, 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   # 프로젝트의 구성 목록
npx hyperframes docs           # 문서 열기
npx hyperframes benchmark .    # 렌더링 성능 벤치마크

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-Skills

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.

shengdabai/Tony-Claude-Code-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.

관련 스킬