Communitygithub.com

Biznomad/agent-skills

HyperFrames CLI 개발 루프 — `npx hyperframes` 명령어로 스캐폴딩(init), 린트(lint), 인스펙트(inspect), 프리뷰, 렌더링, 환경 문제 해결(doctor, browser, info, upgrade)을 수행합니다. HyperFrames 빌드/렌더 환경을 다루거나 해당 명령어를 실행할 때 사용하세요. 에셋 전처리 명령어(`tts`, `transcribe`, `remove-background`)는 `hyperframes-media` 스킬을 사용하세요.

agent-skills란 무엇인가요?

이 스킬은 HyperFrames CLI 도구를 위한 포괄적인 개발 워크플로우를 제공합니다. `npx hyperframes` 명령어를 기반으로 하며, Node.js >= 22와 FFmpeg가 필요합니다. 주요 기능으로는 `init`을 통한 프로젝트 스캐폴딩, `lint`를 통한 HTML 컴포지션 검증 (누락된 data-composition-id, 중복 트랙, 미등록 타임라인 탐지), `inspect`를 통한 시각적 레이아웃 검사 (텍스트 오버플로, 클리핑 문제 감지), `preview`를 통한 핫 리로드 개발 서버, `render`를 통한 최종 MP4/WebM 출력 등이 있습니다. 또한 `doctor`, `browser`, `info`, `upgrade` 명령어로 환경 문제를 진단하고 해결할 수 있습니다. 주요 워크플로우는 스캐폴드 → 작성 → 린트 → 인스펙트 → 프리뷰 → 렌더 순서이며, 린트와 인스펙트는 프리뷰 전에 반드시 수행해야 합니다. 이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)와 CI/CD 환경에서 모두 사용할 수 있도록 설계되었으며, `--non-interactive` 플래그로 프롬프트 없이 실행할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-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는 렌더링된 컴포지션을 헤드리스 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        # 정보 수준의 결과
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}를 포함하는 JSON 선언 배열)로 변수를 선언하여 스키마를 정의합니다. 내부 스크립트는 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 20 individual skills — each has its own dedicated page.

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-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/agent-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/agent-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/agent-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/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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/agent-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/agent-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/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-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/agent-skills

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

Biznomad/agent-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/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-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/agent-skills

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

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

관련 스킬