Communitygithub.com

일반 비디오 워크플로우

특정 워크플로우 스킬과 일치하지 않는 모든 비디오 요청에 대한 기본 HyperFrames 제작 워크플로우입니다. 브리프 → 비트 시트 → 구성 → 렌더링의 전체 엔드 투 엔드 프로세스를 다룹니다.

일반 비디오 워크플로우란 무엇인가요?

이 스킬은 HyperFrames 프레임워크를 사용하여 일반 비디오를 제작하는 포괄적인 엔드 투 엔드 워크플로우를 제공합니다. 특정 작업(예: 튜토리얼, 광고, 브랜드 비디오)에 맞춘 전용 스킬이 없을 때 사용하는 기본 작업 방식입니다. 브리프 명확화, 비트 시트 작성, 프로젝트 스캐폴딩, HTML 기반 장면 구성, 린트 및 프리뷰, 최종 렌더링까지 6단계로 구성되어 있으며, 품질 체크리스트를 통해 완성도를 높일 수 있습니다. Claude Code, Cursor, Codex 등 AI 에이전트가 사용자의 비디오 요청을 받아 단계별로 안내하며, 명령줄 도구(`npx hyperframes`)를 활용하여 프로젝트를 초기화하고 렌더링합니다. 특히 `data-hf-*` 속성을 사용한 HTML 마크업 기반의 장면 구성은 직관적이며, TTS(텍스트 음성 변환), 트랜지션, 애니메이션 등을 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/general-video

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

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

문서

일반 비디오 워크플로우은(는) 무엇을 하나요?

1단계 — 브리프 명확화

질문이유
목표? (인지도, 데모, 튜토리얼, 광고)페이싱 및 CTA
대상 청중?톤, 어휘, 스타일
재생 시간?장면 수
화면 비율?16:9, 9:16, 1:1
브랜드 색상 및 폰트?크리에이티브 방향
사용 가능한 에셋?미디어 계획
내레이션 필요 여부?TTS 또는 사전 녹음

2단계 — 비트 시트

00:00 — 후크
00:05 — 컨텍스트
00:15 — 핵심 콘텐츠 (1~3 비트)
00:45 — CTA / 마무리

3단계 — 스캐폴드

npx hyperframes init my-video --template blank
cd my-video

4단계 — 구성 체크리스트

  • 설명적인 이름을 가진 data-hf-scene
  • data-hf-duration 설정
  • 하드 컷이 아닌 경우 data-hf-transition
  • 배경 트랙이 DOM의 첫 번째 자식
  • 필요한 경우 내레이션 클립
  • 텍스트 클립에 data-hf-animate
  • 모든 클립에 data-hf-start 및 data-hf-duration
<!DOCTYPE html>
<html data-hf-version="1">
<head>
  <meta charset="UTF-8" />
  <meta name="hf:canvas-width" content="1920" />
  <meta name="hf:canvas-height" content="1080" />
  <meta name="hf:fps" content="30" />
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;700;900&display=swap" rel="stylesheet" />
  <style>
    * { margin: 0; padding: 0; box-sizing: border-box; }
    body { font-family: 'Inter', sans-serif; }
    :root { --bg: #0d1117; --accent: #58a6ff; --text: #e6edf3; }
  </style>
</head>
<body>
  <div data-hf-scene="hook" data-hf-duration="5s" data-hf-transition="fade">
    <div data-hf-track="bg" data-hf-z="0">
      <div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
           style="width:100%;height:100%;background:var(--bg);position:absolute;"></div>
    </div>
    <div data-hf-track="narration" data-hf-z="1">
      <div data-hf-clip data-hf-tts="Here's why this matters."
           data-hf-tts-voice="en-US-neural-f1" data-hf-start="0.5s"></div>
    </div>
    <div data-hf-track="title" data-hf-z="2">
      <div data-hf-clip data-hf-start="0.3s" data-hf-duration="4.5s"
           data-hf-animate="slide-up"
           style="position:absolute;top:400px;left:0;right:0;text-align:center;">
        <h1 style="font-size:96px;font-weight:900;color:var(--text);">Big Claim Here</h1>
      </div>
    </div>
  </div>
  <div data-hf-scene="content" data-hf-duration="10s" data-hf-transition="cut"></div>
  <div data-hf-scene="cta" data-hf-duration="5s" data-hf-transition="fade"></div>
</body>
</html>

5단계 — 린트 및 프리뷰

npx hyperframes lint
npx hyperframes preview --open

6단계 — 렌더링

export HEYGEN_API_KEY=your_key
npx hyperframes render --out output.mp4

품질 체크리스트

  • 전체 비디오 시청 — 점프 컷, 무음 구간 없음
  • 텍스트 가독성 (1080p에서 최소 24px)
  • 내레이션 페이싱이 자연스러움
  • 음악이 내레이션을 압도하지 않음
  • CTA가 화면에 3초 이상 표시
  • 첫 번째 및 마지막 장면에 로고 포함
  • 올바른 화면 비율

Individual skills in this repo

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

관련 스킬