Communitygithub.com

Biznomad/agent-skills

HyperFrames HTML을 사용하여 비디오 컴포지션, 애니메이션, 타이틀 카드, 오버레이, 캡션, 음성 해설, 오디오 반응형 비주얼 및 장면 전환을 생성합니다.

agent-skills란 무엇인가요?

이 스킬은 HTML을 비디오 제작의 소스 오브 트루스(truth)로 사용하는 HyperFrames 프레임워크를 위한 AI 어시스턴트 가이드입니다. 개발자는 HTML 파일에 `data-*` 속성으로 타이밍을 지정하고, GSAP 타임라인으로 애니메이션을 제어하며, CSS로 디자인을 구성하는 방식으로 전체 비디오 제작 워크플로우를 수행할 수 있습니다. 이 스킬은 디자인 시스템 설정(design.md 활용), 프롬프트 확장, 계획 수립, 레이아웃 우선 접근법 등 체계적인 단계를 제공하여 일관된 결과물을 보장합니다. 특히 오디오 반응형 애니메이션(비트 싱크, 글로우, 펄스), 텍스트 강조 효과(마커 스윕, 손그림 원, 버스트 라인), 장면 전환(크로스페이드, 와이프, 리빌, 셰이더 전환) 등을 지원하며, 캡션/자막 동기화와 텍스트 음성 변환(TTS) 기능도 포함합니다. Cursor, Codex, Claude Code 등 다양한 AI 코딩 에이전트와 호환되어 개발자가 코드 기반으로 전문가 수준의 비디오 콘텐츠를 제작할 수 있도록 돕습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes

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

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

문서

HyperFrames

HTML은 비디오의 소스 오브 트루스(truth)입니다. 컴포지션은 타이밍을 위한 data-* 속성, 애니메이션을 위한 GSAP 타임라인, 그리고 디자인을 위한 CSS가 포함된 HTML 파일입니다. 프레임워크는 클립 가시성, 미디어 재생 및 타임라인 동기화를 처리합니다.

접근 방식

탐색 (탐색적 요청 전용)

사용자가 방향을 정하지 않은 개방형 요청("제품 런칭 비디오를 만들어 줘", "브랜드용 콘텐츠를 만들어 줘")의 경우, 색상을 선택하기 전에 의도를 파악하세요:

  • 대상 — 누가 시청하나요? 개발자? 임원? 일반 소비자?
  • 플랫폼 — 어디에서 재생되나요? 소셜 미디어(15초), 웹사이트 히어로, 제품 데모, 내부용?
  • 우선순위 — 무엇이 가장 중요한가요? 모션 품질? 콘텐츠 정확성? 브랜드 충실도? 속도?
  • 변형 — 사용자가 옵션을 원하나요, 아니면 단일 최적안을 원하나요?

구체적인 요청("타이틀 카드 추가", "3번 장면 타이밍 수정")의 경우 탐색 단계를 건너뛰세요.

탐색적 요청의 경우, 의미 있는 차이가 있는 2-3개의 변형을 고려해 보세요. 단순한 색상 변경이 아닌, 다른 페이싱, 에너지 레벨 또는 구조적 접근 방식을 제공하세요. 하나는 안전하고 예상되는 스타일, 하나는 야심 찬 스타일로 구성하세요. 이를 강제하지 마세요 — 적절할 때 사용할 수 있는 도구일 뿐입니다.

1단계: 디자인 시스템

프로젝트에 design.md 또는 DESIGN.md 파일이 있으면 먼저 읽으세요 (리눅스에서는 대소문자가 다른 파일이므로 두 케이스를 모두 확인하세요). 브랜드 색상, 글꼴 및 제약 조건의 소스 오브 트루스입니다. 정확한 값을 사용하세요 — 색상을 임의로 만들거나 글꼴을 대체하지 마세요. 모든 형식(YAML 프론트매터, 산문, 표 등)이 가능합니다 — 값을 추출하기만 하면 됩니다.

로컬에서 찾을 수 없는 글꼴이 지정된 경우(fonts/ 디렉토리에 .woff2 파일이 없거나 내장 글꼴이 아닌 경우), HTML을 작성하기 전에 사용자에게 경고하세요: "design.md에 [글꼴 이름]이 지정되었지만 글꼴 파일을 찾을 수 없습니다. fonts/에 .woff2 파일을 추가해 주세요. 그렇지 않으면 [가장 가까운 내장 대체 글꼴]로 대체하겠습니다."

design.md가 없으면 사용자에게 선택지를 제공하세요:

  1. 사용자가 스타일이나 분위기를 지정했나요? → visual-styles.md에서 8개의 명명된 프리셋을 읽고 가장 가까운 것을 선택하세요.
  2. 시각적으로 옵션을 탐색하고 싶나요? → 디자인 피커 실행: references/design-picker.md에서 전체 워크플로우를 읽으세요. 시각적 피커 페이지를 제공합니다. 사용자가 브라우저에서 분위기, 팔레트, 타이포그래피, 모션을 구성한 다음 생성된 design.md를 복사하여 대화 내용에 붙여넣습니다.
  3. 건너뛰고 빠르게 진행하고 싶나요? → 분위기, 라이트/다크, 브랜드 색상/글꼴을 물어보세요. 그런 다음 house-style.md에서 팔레트를 선택하세요.

design.md는 브랜드를 정의합니다. 비디오 컴포지션 규칙을 정의하지 않습니다. 비디오 컴포지션 규칙은 references/video-composition.md와 house-style.md에서 제공됩니다. 브랜드 색상은 비디오에 적합한 스케일로 사용하세요 — 웹 UI 투명도가 아닙니다.

2단계: 프롬프트 확장

모든 컴포지션(단일 장면 조각 및 사소한 편집 제외)에서 항상 실행하세요. 이 단계는 사용자의 의도를 design.md 및 house-style.md에 근거하여 일관된 중간 결과물을 생성하며, 모든 다운스트림 에이전트가 동일하게 읽습니다.

전체 프로세스 및 출력 형식은 references/prompt-expansion.md를 읽으세요.

3단계: 계획

HTML을 작성하기 전에 높은 수준에서 생각하세요:

  1. 무엇 — 시청자가 무엇을 경험해야 하나요? 내러티브 아크, 주요 순간 및 감정적 비트를 식별하세요.
  2. 구조 — 몇 개의 컴포지션, 서브 컴포지션인지 인라인인지, 어떤 트랙이 무엇을 전달하는지(비디오, 오디오, 오버레이, 캡션).
  3. 리듬 — 구현 전에 장면 리듬을 선언하세요. 어떤 장면이 빠른 히트이고, 어떤 장면이 유지되며, 셰이더가 어디에 위치하고, 에너지가 어디서 정점에 도달하는지. 패턴 이름을 지정하세요: 빠름-빠름-느림-빠름-셰이더-유지. 리듬 템플릿은 references/beat-direction.md를 읽으세요.
  4. 타이밍 — 어떤 클립이 지속 시간을 결정하고, 전환이 어디에 위치하며, 페이싱은 어떠한지.
  5. 레이아웃 — 먼저 최종 상태를 구축하세요. 아래 "애니메이션 전 레이아웃"을 참조하세요.
  6. 애니메이션 — 그런 다음 아래 규칙을 사용하여 모션을 추가하세요.

요청된 것을 구축하세요. "타이틀 카드" 요청은 "타이틀 카드 + 3개의 지원 장면 + 배경 음악 + 캡션"에 대한 요청이 아닙니다. 모든 장면, 모든 요소, 모든 트윈은 그 존재 가치를 증명해야 합니다. 추가 장면이나 요소가 작품을 진정으로 향상시킨다면 제안하세요 — 추가하지 마세요.

작은 편집(색상 수정, 타이밍 조정, 하나의 요소 추가)의 경우 바로 규칙으로 건너뛰세요.

<하드-게이트> 컴포지션 HTML을 작성하기 전에 — 1단계에서 시각적 정체성을 확인했는지 검증하세요. #333, #3b82f6 또는 Roboto를 사용하고 있다면, 이 단계를 건너뛴 것입니다. </하드-게이트>

애니메이션 전 레이아웃

모든 요소를 가장 가시성이 높은 순간 — 완전히 진입하고, 올바르게 배치되었으며, 아직 종료되지 않은 프레임 — 에 배치하세요. 이를 정적 HTML+CSS로 먼저 작성하세요. 아직 GSAP은 없습니다.

이것이 중요한 이유: 애니메이션 시작 상태(화면 밖, 0으로 축소, 투명도 0)에 요소를 배치하고 최종 위치로 추측하여 트윈하면, 최종 레이아웃을 추측하게 됩니다. 겹침은 비디오가 렌더링될 때까지 보이지 않습니다. 최종 상태를 먼저 구축하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.

프로세스

  1. 각 장면의 히어로 프레임을 식별하세요 — 대부분의 요소가 동시에 보이는 순간입니다. 이것이 구축할 레이아웃입니다.
  2. 해당 프레임에 대한 정적 CSS를 작성하세요. .scene-content 컨테이너는 width: 100%; height: 100%; padding: Npx;와 display: flex; flex-direction: column; gap: Npx; box-sizing: border-box를 사용하여 전체 장면을 채워야 합니다. 패딩을 사용하여 콘텐츠를 안쪽으로 밀어 넣으세요 — 콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마세요. 절대 위치 콘텐츠 컨테이너는 남은 공간보다 콘텐츠가 높을 때 넘칩니다. position: absolute는 장식용으로만 예약하세요.
  3. gsap.from()으로 진입을 추가하세요 — 화면 밖/투명에서 CSS 위치로 애니메이션을 적용하세요. CSS 위치는 기본 진실입니다. 트윈은 그 위치에 도달하는 과정을 설명합니다. (data-composition-src로 로드된 서브 컴포지션에서는 gsap.fromTo()를 선호합니다 — references/motion-principles.md의 부하 지지 GSAP 규칙 참조).
  4. gsap.to()로 종료를 추가하세요 — CSS 위치에서 화면 밖/투명으로 애니메이션을 적용하세요.

예시

/* scene-content가 장면을 채우고, 패딩이 콘텐츠를 배치합니다 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* 컨테이너는 모든 장면 크기(1920x1080, 1080x1920 등)를 채웁니다.
   패딩이 콘텐츠를 배치합니다. Flex + gap이 간격을 처리합니다. */

잘못된 예 — 하드코딩된 치수와 절대 위치:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// 3단계: 해당 위치로 애니메이션 적용
 tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
 tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
 tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

 // 4단계: 해당 위치에서 애니메이션 종료
 tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
 tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
 tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

요소가 시간에 따라 공간을 공유할 때

요소 A가 동일한 영역에서 요소 B가 진입하기 전에 종료되면, 두 요소 모두 각자의 히어로 프레임에 대해 올바른 CSS 위치를 가져야 합니다. 타임라인 순서는 시각적으로 공존하지 않음을 보장합니다. 그러나 레이아웃 단계를 건너뛰면 타이밍 오류로 인해 실수로 겹치는 경우를 잡을 수 없습니다.

의도적인 겹침의 기준

레이어 효과(텍스트 뒤의 글로우, 그림자 요소, 배경 패턴) 및 z-스택 디자인(카드 스택, 깊이 레이어)은 의도적인 것입니다. 레이아웃 단계는 비의도적인 겹침을 잡기 위한 것입니다 — 두 헤드라인이 서로 위에 겹쳐지거나, 통계가 레이블을 가리거나, 콘텐츠가 프레임 밖으로 넘치는 경우.

데이터 속성

모든 클립

속성필수 여부값
id예고유 식별자
data-start예초 또는 클립 ID 참조 ("el-1", "intro + 2")
data-durationimg/div/컴포지션에 필수초. 비디오/오디오는 미디어 지속 시간을 기본값으로 사용.
data-track-index예정수. 동일 트랙 클립은 겹칠 수 없음.
data-media-start아니요소스 트림 오프셋 (초)
data-volume아니요0-1 (기본값 1)

data-track-index는 시각적 레이어링에 영향을 주지 않습니다 — CSS z-index를 사용하세요.

컴포지션 클립

속성필수 여부값
data-composition-id예고유 컴포지션 ID
data-start예시작 시간 (루트 컴포지션: "0" 사용)
data-duration예GSAP 타임라인 지속 시간보다 우선
data-width / data-height예픽셀 치수 (1920x1080 또는 1080x1920)
data-composition-src아니요외부 HTML 파일 경로
data-variable-values아니요서브 컴포지션 호스트의 인스턴스별 변수 재정의 JSON 객체

루트 <html> 요소:

속성필수 여부값
data-composition-variables아니요선언된 변수의 JSON 배열 (id/type/label/default) — Studio 편집 UI를 구동하고 getVariables()의 기본값 제공

컴포지션 구조

data-composition-src를 통해 로드된 서브 컴포지션은 <template> 래퍼를 사용합니다. 독립형 컴포지션(메인 index.html)은 <template>을 사용하지 않습니다 — data-composition-id div를 <body>에 직접 배치합니다. 독립형 파일에 <template>을 사용하면 모든 콘텐츠가 브라우저에서 숨겨져 렌더링이 깨집니다.

서브 컴포지션 구조:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- 콘텐츠 -->
    <style>
      [data-composition-id="my-comp"] {
        /* 스코프 스타일 */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // 트윈...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

루트에서 로드: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

변수 (매개변수화된 컴포지션)

소스 HTML을 편집하지 않고 동일한 컴포지션을 다른 콘텐츠(제목, 테마 색상, 가격, 캡션 등)로 렌더링합니다.

세 단계 패턴:

  1. 선언 — 컴포지션의 <html> 루트에 data-composition-variables로 변수를 선언합니다. 각 항목에는 id, type (string, number, color, boolean, enum 중 하나), label, default가 필요합니다. 열거형 항목은 options: [{value, label}, ...]도 필요합니다.
  2. 읽기 — 컴포지션의 스크립트 내에서 window.__hyperframes.getVariables()로 해결된 값을 읽습니다. 선언된 기본값 + 인스턴스별 재정의 + CLI 재정의의 병합된 결과를 반환합니다.
  3. 재정의 — 렌더링 시 npx hyperframes render --variables '{...}' (최상위) 또는 호스트 요소의 data-variable-values='{...}' (서브 컴포지션의 인스턴스별)로 재정의합니다.
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Title","default":"Hello"},
  {"id":"theme","type":"enum","label":"Theme","default":"light","options":[
    {"value":"light","label":"Light"},
    {"value":"dark","label":"Dark"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# 개발 미리보기는 선언된 기본값을 사용합니다
npx hyperframes preview

# 재정의로 렌더링
npx hyperframes render --variables '{"title":"Q4 Report","theme":"dark"}' --output q4.mp4

# 또는 JSON 파일에서
npx hyperframes render --variables-file ./vars.json

서브 컴포지션의 인스턴스별 값: data-composition-src를 통해 로드된 서브 컴포지션 내에서도 동일한 getVariables()가 작동합니다. 각 호스트 요소는 자체 값을 전달합니다:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"


…

[번역을 위해 잘림]

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

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

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

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.

관련 스킬