Communitygithub.com

Biznomad/claude-skills

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

claude-skills란 무엇인가요?

이 스킬은 HyperFrames CLI의 전체 개발 워크플로우를 위한 것입니다. `npx hyperframes` 명령어를 통해 프로젝트 스캐폴딩, 린트, 시각적 검사, 미리보기, 렌더링 및 환경 진단을 제공합니다. Node.js >= 22와 FFmpeg가 필요하며, `init`, `lint`, `inspect`, `preview`, `render`, `doctor`, `browser`, `info`, `upgrade` 등의 하위 명령어를 지원합니다. 주요 용도는 비디오 컴포지션 프로젝트를 빠르게 시작하고, 레이아웃 오류(텍스트 넘침, 클리핑 등)를 잡아내며, 최종 렌더링까지 원활하게 이어지도록 돕는 것입니다. Cursor, Codex, Claude Code 등에서 사용할 수 있으며, 에셋 전처리(tts, transcribe, remove-background)는 별도의 `hyperframes-media` 스킬로 분리되어 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-skills/tree/HEAD/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는 렌더링된 컴포지션을 headless 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 스킬을 호출하세요. 스캐폴드는 Studio의 Tailwind v3 설정이 아닌, 브라우저 런타임을 통한 Tailwind v4.2를 사용합니다.

린팅

npx hyperframes lint                  # 현재 디렉토리
npx hyperframes lint ./my-project     # 특정 프로젝트
npx hyperframes lint --verbose        # info 수준 결과
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)

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

프로젝트를 사용자에게 돌려줄 때는 소스 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, 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를 사용하세요.

매개변수화된 렌더: 컴포지션은 <html> 루트에 data-composition-variables 를 통해 변수를 선언합니다 — 이는 JSON 선언 배열 ({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 17 individual skills — each has its own dedicated page.

Biznomad/claude-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/claude-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/claude-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/claude-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/claude-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.

Biznomad/claude-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-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.

관련 스킬