Communitygithub.com

비디오 크리에이터

스토리가 있는 전문 시네마틱 1920×1080 MP4 비디오 제작 기술. HyperFrames, GSAP 애니메이션, TTS 음성 해설, 동기화된 자막을 사용하며, 제품·서비스·이벤트·브랜드 영상 제작 요청 시 사용됩니다.

비디오 크리에이터란 무엇인가요?

이 기술은 제품 데모, 서비스 홍보, 이벤트 티저, 브랜드 런칭, 기업 피치, 소셜 광고, 설명 영상 등 모든 종류의 비디오를 전문적으로 제작하는 풀스택 파이프라인입니다. HyperFrames HTML 컴포지션을 기반으로 GSAP 애니메이션, Kokoro ONNX TTS 음성 해설, Whisper 음성 인식을 통한 단어 수준 자막 동기화, Canvas 2D 파티클 효과, SVG 애니메이션, 키네틱 타이포그래피 등 다양한 시각 효과를 지원합니다. 또한 glitch, push, blur, color blocks 등 6가지 이상의 장면 전환 효과와 완전한 프로덕션 파이프라인(브리핑 → 스크립트 → 디자인 시스템 → 음성 해설 → 전사 → 장면 리듬 계획 → HTML 빌드 → 린트 → 검증 → 렌더링)을 제공합니다. CLI 기반으로 작동하며 npx와 Python을 통해 모든 단계를 자동화할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/digitaleflex/GitHub-Cyber-Scanner-Pro/tree/HEAD/.agents/skills/video-creator

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

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

문서

비디오 크리에이터은(는) 무엇을 하나요?

제품, 서비스, 이벤트, 브랜드를 위한 전문 시네마틱 비디오 제작. 모든 출력물은 1920×1080 MP4 포맷으로 음성 해설, 동기화된 자막, 풍부한 애니메이션, 다양한 장면 전환 효과를 포함합니다.

빠른 시작 (3개 명령어)

# 1. 프로젝트 스캐폴딩
npx --yes [email protected] init my-video

# 2. 음성 해설 생성
python3 -c "from kokoro_onnx import Kokoro; import soundfile as sf; k=Kokoro('models/kokoro-v1.0.onnx','models/voices-v1.0.bin'); s,r=k.create(open('script.txt').read(),voice='bm_george',speed=0.92,lang='en-gb'); sf.write('narration.wav',s,r)"

# 3. 자막을 위한 전사
npx --yes [email protected] transcribe narration.wav --model small.en

# 4. 렌더링
npx --yes [email protected] render

프로덕션 파이프라인

항상 다음 순서를 따르세요 — 단계를 건너뛰지 마세요:

1. 브리핑     → 대상, 플랫폼, 길이, 톤
2. 스크립트   → 내레이션 작성 (~2.5 wps), 첫 후크
3. design.md  → 브랜드 색상, 폰트, 모션 에너지
4. 음성 해설  → npx hyperframes tts 또는 python kokoro_onnx 직접 사용
5. 전사       → npx hyperframes transcribe → transcript.json
6. 계획       → HTML 작성 전 장면 리듬 선언
7. 빌드       → 레이아웃 우선 → GSAP 애니메이션
8. 린트       → npx hyperframes lint (오류 0 필수)
9. 검증       → npx hyperframes validate --no-contrast
10. 렌더링    → npx hyperframes render

1단계 — 프로덕션 브리핑

질문하거나 (컨텍스트에서 추론):

  • 주제: 제품 / 서비스 / 이벤트 / 브랜드?
  • 대상: 기업, 개발자, 소비자, 투자자?
  • 플랫폼: 소셜 (15초), 웹사이트 히어로 (30초), 제품 데모 (60초), 프레젠테이션?
  • 톤: 권위적, 에너지 넘치는, 따뜻한, 드라마틱, 기술적?
  • 에셋: 브랜드 색상, 로고, 스크린샷, 기존 카피?

대상별 시작점은 references/brief-templates.md를 참조하세요.

2단계 — 스크립트 작성

속도 공식: 자연스러운 속도에서 초당 2.5단어

  • 15초 → 약 37단어
  • 30초 → 약 75단어
  • 60초 → 약 150단어

구조: 후크 → 문제/스토리 → 증명 → CTA

후크 패턴 (일반적인 시작 금지):

  • 대담한 주장: "현대 공학을 움직이는 금융 인프라."
  • 대비: "당신의 에이전트는 배포되었지만 아무도 모니터링하지 않습니다."
  • 질문: "당신의 전체 팀(인간과 AI)이 하나처럼 움직인다면?"
  • 숫자 충격: "기업 AI 프로젝트의 40%가 거버넌스에서 실패합니다."

대상별 음성 톤:

  • 기업 → 선언적, 신중한, bm_george 목소리
  • 개발자 → 직접적, 기술적, am_adam 목소리
  • 소비자 → 따뜻한, 스토리 중심의, af_heart 목소리
  • 스타트업/에너지 → 펀치감 있는, 빠른, af_sky 목소리

스크립트에서 숫자는 단어로 작성하세요 (TTS는 문자 그대로 읽음): 10x → ten times, $2.3T → nearly two point three trillion dollars.

비디오 유형별 전체 스크립트 예시는 references/script-patterns.md를 참조하세요.

3단계 — 디자인 시스템 (design.md)

HTML을 작성하기 전에 항상 design.md를 만드세요. 이는 브랜드 계약을 정의합니다.

필수 필드:

colors:
  bg: "#0A0A0A"           # 기본 배경 (어둡거나 밝음)
  accent: "#E63946"       # 주요 액션 색상
  accent2: "#10b981"      # 보조 액션 색상
  text: "#FFFFFF"
  muted: "#999999"
  border: "#141111"
typography:
  headline: { fontFamily: "Space Grotesk", fontWeight: 800 }
  label:    { fontFamily: "Space Mono", fontWeight: 700 }
motion:
  energy: high | medium | low
  transition: glitch | blur | push | cover

시각 스타일 선택기 (전체 YAML 토큰은 references/visual-styles.md 참조):

스타일최적 대상특징
Deconstructed기술, SaaS, 보안스캔 라인, 거친 테두리, Space Grotesk/Mono
Maximalist런칭, 발표거대한 타입이 프레임을 채움, 강렬한 색상
Velvet Standard기업, 럭셔리넓은 자간, 여유로운 공간
Data DriftAI, ML, 핀테크파티클 필드, 얇은 미래형 산세리프
Shadow Cut드라마틱한 공개, 보안거의 단색 + 피 악센트
Folk Frequency소비자, 커뮤니티대담한 색상, 바운스, 패턴

4단계 — 음성 해설 생성

npx 사용 (가능할 때 선호)

npx --yes [email protected] tts script.txt --voice bm_george --output narration.wav --speed 0.92

Python 직접 사용 (npx 실패 시 대체)

# 최초 실행: 모델 다운로드 (~340MB 전체, 캐시됨)
curl -L -o models/kokoro-v1.0.onnx \
  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx
curl -L -o models/voices-v1.0.bin \
  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin

# 생성
python3 << 'EOF'
from kokoro_onnx import Kokoro
import soundfile as sf
k = Kokoro("models/kokoro-v1.0.onnx", "models/voices-v1.0.bin")
text = open("script.txt").read().strip()
samples, rate = k.create(text, voice="bm_george", speed=0.92, lang="en-gb")
sf.write("narration.wav", samples, rate)
print(f"생성됨: {len(samples)/rate:.1f}초")
EOF

음성 가이드:

음성특성사용처
bm_george권위적인 영국 남성기업, B2B, 기조연설
bf_emma또렷한 영국 여성튜토리얼, 문서, 프리미엄
am_michael자신감 있는 미국 남성마케팅, 프로모션, SaaS
am_adam중립적인 미국 남성개발자 도구, 설명 영상
af_heart따뜻한 미국 여성소비자, 웰빙, 개인화
af_sky에너지 넘치는 미국 여성소셜 광고, 런칭, 라이프스타일

의존성 설치 (한 번만):

pip install kokoro-onnx soundfile

5단계 — 전사 (단어 수준 자막)

npx --yes [email protected] transcribe narration.wav --model small.en
# → 단어별 타임스탬프가 포함된 transcript.json 생성

출력 형식:

[
  { "text": "Enterprise", "start": 0.03, "end": 0.82 },
  { "text": "teams", "start": 0.82, "end": 1.18 }
]

타임스탬프 사용처:

  1. 장면 전환을 음성 문장 경계에 맞춤
  2. 단어별 자막 애니메이션 구동 (단어당 팝인)
  3. 시각적 강조(버스트 라인, 하이라이트)를 주요 명사에 동기화

6단계 — 장면 리듬 계획

HTML을 작성하기 전에 리듬을 선언하세요. 패턴 이름을 지정하세요:

SLAM → breathe → CASCADE → PUNCH → CTA           (제품 런칭)
PAIN → GLIMPSE → PROOF → CONVICTION              (문제/해결)
HOOK → STORY → PROOF → SCALE → CTA              (기업 피치)
TEASE → REVEAL → DETAIL → DETAIL → CTA          (기능 쇼케이스)

장면 타이밍 템플릿 (30초 기업):

장면 1: 문제/후크      0–7초    (내레이션 문장 1-2)
장면 2: 플랫폼 소개    7–10초   (문장 3)
장면 3: 기능 데모     10–17초   (문장 4-5)
장면 4: 증명/통계    17–21초   (문장 6)
장면 5: 규모          21–28초   (문장 7-8)
장면 6: CTA           28–32초   (문장 9)

길이별 타이밍 템플릿은 references/scene-timing.md를 참조하세요.

7단계 — 컴포지션 빌드

HTML 구조 (필수)

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<style>
body { margin:0; width:1920px; height:1080px; overflow:hidden; background:#0A0A0A; }
.scene { position:absolute; top:0; left:0; width:1920px; height:1080px; overflow:hidden; }
#s1 { z-index:1; background:#0A0A0A; }        /* 장면 1 — 기본 표시 */
#s2 { z-index:2; background:#0A0A0A; opacity:0; }  /* 나머지는 숨김 */
</style>
</head>
<body>
<div id="root" data-composition-id="main" data-width="1920" data-height="1080"
     data-start="0" data-duration="32">

  <!-- 오디오 (항상 비디오와 분리) -->
  <audio id="vo" data-start="0" data-duration="31.1" data-track-index="10"
         data-volume="1" src="narration.wav"></audio>

  <!-- 전환 오버레이 (항상 모든 장면 위에) -->
  <div id="ov-r" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:80;background:#E63946;opacity:0;pointer-events:none"></div>

  <!-- 장면들 -->
  <div id="s1" class="scene"><!-- 콘텐츠 --></div>
  <div id="s2" class="scene"><!-- 콘텐츠 --></div>
</div>

<script>
window.__timelines = window.__timelines || {};
var tl = gsap.timeline({ paused: true });
// ... 애니메이션 ...
window.__timelines["main"] = tl;
</script>
</body>
</html>

애니메이션 전 레이아웃 (변경 불가)

  1. 먼저 순수 CSS로 각 장면의 최종 상태를 구축하세요.
  2. 콘텐츠 컨테이너: display:flex; flex-direction:column; padding:120px 160px; width:100%; height:100%;
  3. 콘텐츠에는 절대 position:absolute; top:Npx를 사용하지 마세요 — 장식 요소에만 사용하세요.
  4. 레이아웃이 확인된 후 gsap.fromTo()를 추가하세요.
  5. npx hyperframes inspect를 실행하여 오버플로우가 없는지 확인하세요.

GSAP 규칙

// 장면 내에서 결정론적 탐색을 위해 항상 fromTo(from 대신) 사용
// tl.fromTo("#el", { opacity:0, y:40 }, { opacity:1, y:0, duration:0.5, ease:"back.out(2)" }, 1.2);

// 주변 모션을 위해 절대 gsap.to()를 직접 사용하지 마세요 — 반드시 tl에 사용
// tl.to("#glow", { scale:1.08, yoyo:true, repeat:4, duration:2, ease:"sine.inOut" }, 0);

// repeat:-1 금지 (캡처 엔진 중단) — 유한 반복 계산
// 4초 비트의 경우: Math.ceil(4 / 2) = 2 사이클
// tl.to("#pulse", { scale:1.1, yoyo:true, repeat:3, duration:2, ease:"sine.inOut" }, 0);

// 장면 종료 하드 킬
// tl.set("#s1", { opacity:0, visibility:"hidden" }, exitTime);

// 항상 등록
window.__timelines["main"] = tl;

장면 밀도 요구 사항

모든 장면에는 반드시 다음이 있어야 합니다:

  • 배경 레이어: 방사형 글로우 + 그리드/패턴 + 고스트 텍스트 + 스캔라인 (2–5개 요소)
  • 콘텐츠 레이어: 헤드라인 + 부제목 + 지원 요소 (3–5개 요소)
  • 전경 악센트: 코너 마크 + 구분선 + 레이블/배지 (3개 이상 요소)
  • 총합: 최소 8–10개 시각 요소

장면별 요소 체크리스트는 references/scene-density.md를 참조하세요.

전환 라이브러리

전체 코드는 references/transitions.md를 참조하세요. 빠른 선택:

에너지전환코드 패턴
혼돈 → 명확블러 크로스페이드tl.to(old, {filter:"blur(14px)",scale:1.04,opacity:0,duration:0.5})
레벨 업세로 푸시tl.to(old,{y:-1080,duration:0.45,ease:"power3.inOut"}, T)
다음 항목슬라이드 왼쪽 푸시tl.to(old,{x:-1920,duration:0.45,ease:"power3.inOut"}, T)
하드 컷검은색 딥tl.to("#ov-k",{opacity:1,duration:0.25}) 다음 tl.set(new,{opacity:1})
큰 순간계단식 컬러 블록빨간색과 초록색 블록이 슬라이드하며 아래 장면 교체
산업적글리치RGB 오버레이 지터, ±40px로 6프레임, 0.35초

마지막 장면의 페이드 투 블랙을 제외하고는 전환 전에 종료 애니메이션을 사용하지 마세요.

애니메이션 기법 라이브러리

1. Canvas 2D 파티클 필드 (배경 주변 분위기)

<canvas id="bg-canvas" width="1920" height="1080" style="position:absolute;top:0;left:0;z-index:1"></canvas>
<script>
var c=document.getElementById("bg-canvas"),ctx=c.getContext("2d");
function h(x,y){var n=x*374761393+y*668265263;n=(n^(n>>13))*1274126177;return((n^(n>>16))&0x7fffffff)/0x7fffffff}
var N=120, pts=[];
for(var i=0;i<N;i++) pts.push({bx:h(i,0)*1920,by:h(i,1)*1080,vx:(h(i,3)-0.5)*0.3,vy:(h(i,4)-0.5)*0.2,r:1+h(i,2)*2.5});
var px={t:0};
tl.to(px,{t:DURATION,duration:DURATION,ease:"none",onUpdate:function(){
  var ti=px.t;
  ctx.clearRect(0,0,1920,1080);
  // 그리드
  ctx.strokeStyle="rgba(230,57,70,0.04)"; ctx.lineWidth=1;
  for(var gx=0;gx<1920;gx+=160){ctx.beginPath();ctx.moveTo(gx,0);ctx.lineTo(gx,1080);ctx.stroke()}
  for(var gy=0;gy<1080;gy+=120){ctx.beginPath();ctx.moveTo(0,gy);ctx.lineTo(1920,gy);ctx.stroke()}
  // 파티클
  for(var i=0;i<N;i++){
    var p=pts[i],x=(p.bx+p.vx*ti*60)%1920,y=(p.by+p.vy*ti*60)%1080;
    if(x<0)x+=1920;if(y<0)y+=1080;
    ctx.fillStyle="rgba(230,57,70,"+(0.15+0.1*h(i,Math.floor(ti*6)))+")";
    ctx.fillRect(x-p.r/2,y-p.r/2,p.r,p.r);
  }
}},0);
</script>

2. SVG 스크리블 밑줄

<span style="position:relative;display:inline-block">
  핵심 문구
  <svg style="position:absolute;left:0;bottom:-8px;width:100%;height:20px" viewBox="0 0 500 20" preserveAspectRatio="none">
    <path id="scr" fill="none" stroke="#E63946" stroke-width="3" stroke-linecap="round"
      stroke-dasharray="800" stroke-dashoffset="800"
      d="M0,10 Q62,0 125,10 Q187,20 250,10 Q312,0 375,10 Q437,20 500,10"/>
  </svg>
</span>
<script>
// DOM에 경로 요소가 존재한 후:
var p=document.getElementById("scr"), l=p.getTotalLength();
gsap.set(p,{strokeDasharray:l,strokeDashoffset:l});
tl.to("#scr",{strokeDashoffset:0,duration:0.7,ease:"power1.inOut"}, START);
</script>

3. 음성 동기화 단어별 키네틱 헤드라인

<div id="headline">
  <span class="w" id="w0">Ship</span>
  <span class="w" id="w1">faster.</span>
  <span class="w" id="w2">CyberAgent.</span>
</div>
<script>
// transcript.json의 단어 시작 시간
var times = [0.0, 0.3, 0.7];
var eases = ["back.out(2.5)", "expo.out", "back.out(3)"];
var dirs  = [{y:60,rotation:4}, {y:80,scale:0.7}, {scale:0.5,rotation:-5}];
times.forEach(function(t,i){
  tl.fromTo("#w"+i,
    Object.assign({opacity:0},dirs[i]),
    Object.assign({opacity:1,y:0,scale:1,rotation:0,duration:0.45,ease:eases[i]},{}),
    t);
});
</script>

4. 버스트 라인 (통계 공개)

<div style="position:relative;display:inline-block">
  <div id="stat-num">10×</div>
  <div style="position:absolute;top:50%;left:50%;width:0;height:0" id="burst">
    <span style="position:absolute;display:block;width:3px;height:52px;background:#E63946;left:-1.5px;top:-52px;transform:rotate(0deg);transform-origin:bottom center;opacity:0"></span>
    <span style="position:absolute;display:block;width:3px;height:38px;background:#E63946;left:-1.5px;top:-38px;transform:rotate(36deg);transform-origin:bottom center;opacity:0"></span>
    <!-- 8-12개의 라인을 30-45도 간격으로 반복 -->

...

[나머지 내용은 원본과 동일하므로 생략됨 – 기술 상세를 유지하며 번역됨]

관련 스킬