비디오 만들기 – 초보자에서 MP4 완성까지의 스킬
두 단계, 8개의 순차적 게이트로 구성됩니다. 각 게이트는 다음 게이트가 사용할 구체적인 결과물을 생성합니다. 게이트를 건너뛰지 마세요.
이 스킬을 사용해야 하는 경우 – 그리고 인계해야 하는 경우
이 스킬을 사용해야 하는 경우:
- 사용자가 HyperFrames를 처음 사용하며 개념, 스크립트, 개요에서 시작하는 경우
- 프레임워크 참고 자료가 아닌 종단간 워크스루를 원하는 경우
- 아직 형식을 결정하지 못한 경우
인계해야 하는 경우:
- 사용자가 URL을 붙여넣고 해당 사이트의 비디오를 원하는 경우 →
/website-to-hyperframes호출 - 사용자가 명시적으로 9:16 세로형 토킹헤드(얼굴 카메라 + 장면 오버레이)를 원하는 경우 → 여기서 게이트 1~4를 실행한 후 게이트 5부터
/short-form-video호출 - 사용자가 비디오가 아닌 프레임워크 규칙을 요청하는 경우 →
/hyperframes호출
라우팅 참고 (AI Edit Video 파이프라인): 이 스킬이 프로젝트 브리프에서 실행될 때, 편집 프롬프트의
STYLE DESIGN 및 PHONG CÁCH DỰNG (비디오 스타일) 섹션이 아래 인터뷰 기본값을 재정의합니다 –
브리프가 이미 답변한 스타일 질문을 다시 묻지 마세요.
두 단계
- 1단계 – 인터뷰 (게이트 1~4): 코드를 건드리기 전에 모든 것을 수집하는 한 번의 대화식 패스. 의도, 형식, 스크립트, 목소리, 스타일, 에셋, 페이싱.
BRIEF.md로 종합하고 명시적 승인을 기다립니다. - 2단계 – 빌드 (게이트 5~8): 스캐폴딩 → 스토리보드 → 컴포지션 → 린트 → 스튜디오 미리보기 → 드래프트 렌더 → 시각적 검증 → MP4 미리보기 → 최종 렌더.
게이트 1 · 의도 및 형식
AskUserQuestion을 통해 한 번에 하나의 질문을 하고, 가능하면 객관식으로 제시하세요.
- 이 비디오는 무엇을 위한 것인가요? (프로모션 · 소셜 광고 · 출시 티저 · 제품 데모 · 튜토리얼 · 설명 영상 · 인트로/아웃트로 카드 · 기타)
- 대상 시청자는 누구인가요? (자유 응답)
- 목표 길이는? (10
20초 숏 · 2045초 프로모션 · 4590초 설명 영상 · 1.53분 강의 · 사용자 지정) - 화면 비율은? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- 프레임 레이트는? (30 기본 · 60 선명한 UI용 · 24 시네마틱)
- 플랫폼 / 전달 제약 조건은? (파일 크기 · 마감일 · 재생 위치)
게이트: 여섯 가지 모두 캡처됨. 답변이 9:16 + 얼굴 카메라인 경우 게이트 5에서 /short-form-video로 인계할 계획을 세웁니다.
전체 질문 은행: Read: references/interview-questions.md
게이트 2 · 스크립트 및 음성
- 스크립트 출처? (붙여넣기 · 개요 → 제가 작성 · 제가 녹음 · 텍스트에서 TTS · 나레이션 없음)
- TTS인 경우: 음성 선호도.
npx hyperframes tts --help에서 선택지를 제공하세요. 페이스도 캡처합니다.hyperframes tts(Kokoro)는 영어 전용입니다 – 베트남어 나레이션은 대신 시스템의/api/tts(Gemini TTS 또는 VieNeu)를 통해 처리합니다. - 얼굴 카메라인 경우: 녹화 경로 · 전체 화면 또는 코너 배치 · 자막 필요? (
npx hyperframes transcribe <file> --model small.en --json– 영어 전용, 베트남어는 noti-tiktok-vn 스킬에 따라 faster-whisper 사용) - 자막? (끄기 · 하이프 · 코퍼레이트 · 가라오케 단어별 · 미니멀)
게이트: 스크립트 캡처됨 (또는 작성됨), 오디오 계획 캡처됨, 자막 계획 캡처됨.
게이트 3 · 스타일 입력
사용자에게 아무것도 묻기 전에 기존 에셋을 확인하세요. <workspace-root>/assets/ 및 모든 프로젝트 assets/ 폴더를 확인하세요. 이미 있는 것을 요구하지 마세요.
그런 다음 점진적으로 질문하세요 – 사용자가 이 모든 것에 답할 필요는 없습니다:
- 스타일 가이드 또는 브랜드 문서? (붙여넣기/경로 · 없음)
- 색상 팔레트? (16진수 코드 · 없음 – MOTION_PHILOSOPHY 기본값 사용)
- 폰트? (Google Fonts 이름 · 파일 경로 · 없음 – Inter + JetBrains Mono 기본값 사용)
- 로고 파일? (경로 · 없음). 브랜드 이름이 언급되었지만 파일이 제공되지 않은 경우:
assets/brand-logos/에서 찾거나POST /api/brand-logos {"name":"..."}로 가져오세요 –404 BRAND_LOGO_NOT_FOUND응답이 있는 경우에만 텍스트 워드마크가 허용됩니다. 로고를 그리거나 생성하지 마세요. - 분위기 참고 영상? (URL/경로 · 없음)
- 기타 에셋? (스크린샷 · 제품 사진 · B-롤 · 음악 – 경로 목록)
- MOTION_PHILOSOPHY 미학 (검은 캔버스 · 크롬 타입 · 원근 격자 · 채찍 전환) 또는 다른 느낌?
- 페이싱? (역동적 1
2초 · 균형 23초 · 여유 3~5초) - 음악? (없음 · 앰비언트 패드 0.15 · 배경 음악 0.4 · 전체 0.8 – 사용자가 가지고 있으면 파일 경로)
- 아웃트로 / 행동 촉구 텍스트?
사용자에게 브랜드를 강요하지 마세요. 사용자가 명시적으로 스타일 제공을 거부한 경우에만 MOTION_PHILOSOPHY 기본값으로 대체합니다.
전체 스타일 흐름 + MOTION_PHILOSOPHY 기본값: Read: references/style-intake.md
게이트 4 · 브리프 종합 (빌드 전 하드 게이트)
MOTION_PHILOSOPHY.md를 읽으세요 – 워크스페이스 루트에 있으면 반드시 읽어야 합니다. 없으면references/style-intake.md의 기본값을 진행하고 브리프에 부재 사실을 기록하세요.- 프로젝트 위치가 명확하지 않으면 어디에 둘지 물어보세요:
video-projects/가 존재하면 →video-projects/<slug>/사용- 그렇지 않으면 → 사용자에게 물어보세요
<project-folder>/BRIEF.md작성:- 슬러그 · 의도 · 대상 · 치수 · fps · 길이
- 스크립트 (전체 또는 개요)
- 음성 선택 · 자막 계획 · 얼굴 카메라 계획
- 스타일 프로필: 팔레트 (16진수), 폰트, 로고 경로, 참고 영상
- 페이싱
- 에셋 인벤토리 (경로 포함)
- 아웃트로 / CTA 텍스트
- 브리프를 보여주세요. 명시적 승인을 기다리세요. "네, 빌드하세요"라는 명확한 확인 없이 게이트 5로 진행하지 마세요.
게이트 5 · 스캐폴드 및 스토리보드
먼저 인계 확인
브리프가 9:16 세로형 토킹헤드(얼굴 카메라 + 장면 오버레이)를 설명하는 경우, 지금 /short-form-video를 호출하고 브리프를 인계하세요. 4계층 스캐폴드는 해당 형식에 맞춰 제작되었습니다.
그렇지 않으면 계속 진행:
스캐폴드
mkdir <project-folder>- 비슷한 형식의 형제 프로젝트가 있으면 해당
hyperframes.json+meta.json을 템플릿으로 복사할 것을 제안하세요. 그렇지 않으면 폴더 내에서:npx hyperframes init - 사용자의 슬러그, 치수, fps로
meta.json을 편집하세요. - 제공된 에셋을
<project-folder>/assets/로 복사하세요. - 게이트 3에서
<project-folder>/assets/style-profile.md를 생성하세요 – 팔레트/폰트/로고의 단일 진실 공급원.
스토리보드
references/storyboard-template.md의 템플릿을 사용하여 <project-folder>/STORYBOARD.md를 생성하세요. 모든 비트는 다음을 포함합니다:
비트 N - 제목 (시작–종료, 길이) - 한 문장 개념
시각적 요소: [각 요소, 크기, 애니메이션, 타이밍]
모션 언어: [모션 종류]
사용된 이징: [3~4개의 다른 GSAP 이징]
종료: [다음 비트로의 전환]
오디오: [VO 라인 / SFX / 음악 레이어]
파일 상단: 장면 · 시작 · 길이 · 컴포지션 파일이 있는 타이밍 테이블.
3막 구조 제안:
- 1막 (후크) ≈ 길이의 20%
- 2막 (본문) ≈ 55%
- 3막 (페이오프 + 4~6초 유지의 아웃트로) ≈ 25%
(MOTION_PHILOSOPHY §0 법칙 9, §1.)
사용자 의도를 카탈로그 블록에 매핑: Read: references/catalog-intent-map.md
게이트: 스토리보드 + 타이밍 테이블 표시. 사용자가 승인할 때까지 반복합니다.
게이트 6 · 컴포지션 빌드
프레임워크 규칙을 위해 /hyperframes를 호출하세요. 이 스킬이 스캐폴드와 규율을 소유하고 /hyperframes가 규칙을 적용합니다.
모든 서브 컴포지션 스캐폴드
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* 범위 지정 */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... 트윈 ...
tl.to({}, { duration: SLOT_DURATION }, 0); // 앵커 - MOTION_PHILOSOPHY 법칙 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
전체 보일러플레이트 + 자막 패턴 + 앰비언트 배경 패턴: Read: references/composition-scaffold.md
빌드 규칙
- 앰비언트 배경은 전체 컴포지션 길이 동안
data-track-index="0"에 적용합니다. - 키네틱 타이프 오프너: 단어당 스태거 0.06~0.10초.
- 자막은
index.html에서 루트 컴포지션의 body 레벨 형제로 배치하며, 각각data-track-index ≥ 20을 가집니다. 장면 타임라인 내부에 절대 배치하지 마세요 (MOTION_PHILOSOPHY §3.13). - 카탈로그 블록은
npx hyperframes add <name>으로 설치합니다. 즉시 블록의 CSS를[data-composition-id="..."]로 범위 지정하세요 – 카탈로그 블록은 서브 컴포지션으로 로드될 때 상위 문서로 번지는html, body { ... }규칙과 함께 제공됩니다. - 세로 + 얼굴 카메라: 기본 1920×1080 얼굴을 하단 절반 또는 전체 화면 모드용으로 변환(
translate+scale)하여 감쌉니다. (여기까지 왔다면/short-form-video로의 인계를 강력히 고려하세요.) - 사용자가 제공한 것만 적용하세요. 사용자의 팔레트, 사용자의 폰트, 사용자의 로고. 다른 것은 주입하지 마세요. 사용자가 MOTION_PHILOSOPHY 기본값을 선택했다면
references/style-intake.md에서 팔레트 + 폰트 쌍을 가져오세요.
결정론
Math.random(), Date.now(), 렌더 타임 fetch() 사용 금지. 시드 기반 PRNG 또는 하모닉 신 해시를 사용하세요 (MOTION_PHILOSOPHY §3.10).
게이트 7 · 린트 → 스튜디오 미리보기 (미리보기 게이트 1 – 필수)
npx hyperframes lint– 모든 오류 수정, 경고 분류.- 백그라운드에서
npx hyperframes preview실행. http://localhost:3002에서 "Studio running" 메시지를 기다립니다.- 사용자에게 URL 과 개별 컴포지션 URL (
http://localhost:3002/?comp=<id>)을 전달합니다. 프로젝트에 WebGL 셰이더 블록이 있으면 개별 URL을 먼저 제시하세요 – 소프트웨어 WebGL 폴백이 마스터 컴포지션을 지연시킬 수 있습니다. - 계속 진행하기 전에 명시적인 "좋아 보이네요, 드래프트 렌더링하세요" 확인을 기다리세요. 침묵은 승인이 아닙니다.
핫 리로드가 켜져 있습니다 – 편집 사항이 실시간으로 반영됩니다.
게이트 8 · 드래프트 렌더 → 시각적 검증 → MP4 미리보기 → 최종
드래프트 렌더
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
시각적 검증 (전달 전 필수)
린트 통과 ≠ 디자인 작동. 프레임을 추출하고 보세요.
mkdir -p renders/frames- 모든 비트의 핵심 순간과 모든 전환에 대해:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - 모든 PNG에 대해
Read도구를 호출하세요. Read 도구가 이미지를 컨텍스트에 로드합니다 – 파일 이름만 나열하지 마세요. - 프레임별로 확인: 잘린 얼굴 없음, 장면별 올바른 얼굴 모드, 텍스트 읽기 가능 및 팔레트 준수, 오버플로우 없음, 전환이 의도된 단어에 맞춰짐, 빈 프레임 없음.
- 문제가 있으면: 수정 → 재렌더링 → 재확인. 깨진 드래프트를 절대 출시하지 마세요.
MP4 미리보기 (미리보기 게이트 2 – 필수)
npx serve renders -p 8080 -n
Python의 http.server를 사용하지 마세요 – HTTP Range 요청을 지원하지 않아 탐색이 깨집니다.
사용자에게 http://localhost:8080/<slug>-draft.mp4를 전달하세요. 재생 및 오디오 동기화에 대한 명시적 승인을 기다리세요.
최종 렌더
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
AI Edit Video 파이프라인에서 이것이 끝이 아닙니다: video-pipeline 스킬로 계속 진행하세요 (QC → 렌더 큐를 통해 최종 조립 → outputs/<id>-v<N>.mp4 → meta.json 업데이트 → 썸네일/게시). 파이프라인 외부에서 단독으로 사용하는 경우: 출력 경로를 보고하세요. 완료.
전체 사전 점검 + 전달 전 체크리스트: Read: references/build-checklist.md
비협상 사항 (하중 지지 – 완화하지 마세요)
- 미리보기 게이트 1 (스튜디오) 또는 미리보기 게이트 2 (렌더링된 MP4)를 건너뛰지 마세요. 빌드당 두 개의 게이트, 항상.
- 프레임을 추출하고 Read 도구를 통해 읽을 때까지 렌더가 완료되었다고 말하지 마세요.
- 전용 프로젝트 폴더 안에서만 빌드하세요.
index.html을 워크스페이스 루트에 절대 두지 마세요. - 사용자 워크스페이스를 확인하기 전에 사용자에게 에셋을 요구하지 마세요.
- 모든 서브 컴포지션 타임라인 끝에
tl.to({}, { duration: SLOT_DURATION }, 0)앵커 트윈을 건너뛰지 마세요. MOTION_PHILOSOPHY 법칙 11. - 렌더 로직 내에서
Math.random()/Date.now()를 사용하지 마세요. 시드된 해시만 사용합니다. <video>태그에class="clip"을 추가하지 마세요. 깨집니다.- 사용자에게 브랜드를 강요하지 마세요. 먼저 물어보고, 사용자가 명시적으로 거부한 경우에만 MOTION_PHILOSOPHY 기본값으로 대체하세요.
참고 자료
references/interview-questions.md– 게이트별 전체 질문 은행references/style-intake.md– 스타일 인터뷰 + MOTION_PHILOSOPHY 기본값references/catalog-intent-map.md– "사용자가 X라고 말함 → Y 설치"references/storyboard-template.md– 비트별 템플릿 + 작업 예제references/composition-scaffold.md– 범위 지정 스타일 + IIFE GSAP 보일러플레이트references/build-checklist.md– 사전 점검 + 전달 전 게이트
외부 (워크스페이스 수준):
MOTION_PHILOSOPHY.md– 이 스킬이 존재한다고 가정하는 유일한 외부 참고 자료. 미학 기준선. 파일이 없으면 대체는references/style-intake.md에 있습니다.
관련 스킬
/hyperframes– 프레임워크 규칙, 게이트 6에서 호출/hyperframes-cli– init · lint · preview · render · transcribe · tts/hyperframes-registry– 카탈로그 블록 설치/gsap– GSAP 애니메이션 참조/short-form-video– 9:16 토킹헤드 형식을 위해 게이트 5에서 인계/website-to-hyperframes– 시작 입력이 URL인 경우 게이트 1에서 인계