Communitygithub.com

비디오 제작 – 초보자부터 MP4 완성까지

HyperFrames를 처음 사용하는 사용자를 위한 초보자 친화적인 종합 비디오 제작 스킬입니다. 사용자가 "비디오 만들기", "새 비디오", "처음부터 비디오 제작" 등을 요청하거나 개념, 스크립트, 대략적인 아이디어를 가지고 MP4 완성을 원할 때 사용하세요. 한 번의 인터뷰로 모든 정보를 수집한 후 필수 미리보기 및 시각적 확인 게이트를 거쳐 전체 비디오를 빌드합니다.

비디오 제작 – 초보자부터 MP4 완성까지란 무엇인가요?

이 스킬은 HyperFrames 플랫폼에서 초보자도 쉽게 따라할 수 있도록 설계된 종단간 비디오 제작 워크플로우를 제공합니다. 두 단계(인터뷰 4개 게이트, 빌드 4개 게이트)로 구성되며, 각 게이트는 다음 게이트가 소비할 구체적인 결과물을 생성합니다. 사용자의 의도, 형식, 스크립트, 목소리, 스타일, 에셋, 페이싱을 한 번의 대화식 인터뷰로 수집하여 `BRIEF.md`로 종합하고 명시적 승인을 받은 후, 프로젝트 스캐폴딩, 스토리보드, 컴포지션 빌드, 린트, 스튜디오 미리보기, 드래프트 렌더, 시각적 검증, MP4 미리보기, 최종 렌더를 순차적으로 진행합니다. 특히 9:16 세로형 토킹헤드 형식은 게이트 5에서 `/short-form-video` 스킬로 핸드오프하며, 코드 내 `Math.random()`, `Date.now()`, `render-time fetch()`를 금지하는 결정론적 렌더링 원칙을 따릅니다. 스튜디오 미리보기(게이트 7)와 렌더링된 MP4 미리보기(게이트 8)는 절대 건너뛸 수 없는 필수 게이트이며, 프레임 추출 후 `Read` 도구로 각 프레임을 시각적으로 확인해야 비디오를 전달할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

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

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

문서

비디오 만들기 – 초보자에서 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을 통해 한 번에 하나의 질문을 하고, 가능하면 객관식으로 제시하세요.

  1. 이 비디오는 무엇을 위한 것인가요? (프로모션 · 소셜 광고 · 출시 티저 · 제품 데모 · 튜토리얼 · 설명 영상 · 인트로/아웃트로 카드 · 기타)
  2. 대상 시청자는 누구인가요? (자유 응답)
  3. 목표 길이는? (1020초 숏 · 2045초 프로모션 · 4590초 설명 영상 · 1.53분 강의 · 사용자 지정)
  4. 화면 비율은? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. 프레임 레이트는? (30 기본 · 60 선명한 UI용 · 24 시네마틱)
  6. 플랫폼 / 전달 제약 조건은? (파일 크기 · 마감일 · 재생 위치)

게이트: 여섯 가지 모두 캡처됨. 답변이 9:16 + 얼굴 카메라인 경우 게이트 5에서 /short-form-video로 인계할 계획을 세웁니다.

전체 질문 은행: Read: references/interview-questions.md


게이트 2 · 스크립트 및 음성

  1. 스크립트 출처? (붙여넣기 · 개요 → 제가 작성 · 제가 녹음 · 텍스트에서 TTS · 나레이션 없음)
  2. TTS인 경우: 음성 선호도. npx hyperframes tts --help에서 선택지를 제공하세요. 페이스도 캡처합니다. hyperframes tts (Kokoro)는 영어 전용입니다 – 베트남어 나레이션은 대신 시스템의 /api/tts (Gemini TTS 또는 VieNeu)를 통해 처리합니다.
  3. 얼굴 카메라인 경우: 녹화 경로 · 전체 화면 또는 코너 배치 · 자막 필요? (npx hyperframes transcribe <file> --model small.en --json – 영어 전용, 베트남어는 noti-tiktok-vn 스킬에 따라 faster-whisper 사용)
  4. 자막? (끄기 · 하이프 · 코퍼레이트 · 가라오케 단어별 · 미니멀)

게이트: 스크립트 캡처됨 (또는 작성됨), 오디오 계획 캡처됨, 자막 계획 캡처됨.


게이트 3 · 스타일 입력

사용자에게 아무것도 묻기 전에 기존 에셋을 확인하세요. <workspace-root>/assets/ 및 모든 프로젝트 assets/ 폴더를 확인하세요. 이미 있는 것을 요구하지 마세요.

그런 다음 점진적으로 질문하세요 – 사용자가 이 모든 것에 답할 필요는 없습니다:

  1. 스타일 가이드 또는 브랜드 문서? (붙여넣기/경로 · 없음)
  2. 색상 팔레트? (16진수 코드 · 없음 – MOTION_PHILOSOPHY 기본값 사용)
  3. 폰트? (Google Fonts 이름 · 파일 경로 · 없음 – Inter + JetBrains Mono 기본값 사용)
  4. 로고 파일? (경로 · 없음). 브랜드 이름이 언급되었지만 파일이 제공되지 않은 경우: assets/brand-logos/에서 찾거나 POST /api/brand-logos {"name":"..."}로 가져오세요 – 404 BRAND_LOGO_NOT_FOUND 응답이 있는 경우에만 텍스트 워드마크가 허용됩니다. 로고를 그리거나 생성하지 마세요.
  5. 분위기 참고 영상? (URL/경로 · 없음)
  6. 기타 에셋? (스크린샷 · 제품 사진 · B-롤 · 음악 – 경로 목록)
  7. MOTION_PHILOSOPHY 미학 (검은 캔버스 · 크롬 타입 · 원근 격자 · 채찍 전환) 또는 다른 느낌?
  8. 페이싱? (역동적 12초 · 균형 23초 · 여유 3~5초)
  9. 음악? (없음 · 앰비언트 패드 0.15 · 배경 음악 0.4 · 전체 0.8 – 사용자가 가지고 있으면 파일 경로)
  10. 아웃트로 / 행동 촉구 텍스트?

사용자에게 브랜드를 강요하지 마세요. 사용자가 명시적으로 스타일 제공을 거부한 경우에만 MOTION_PHILOSOPHY 기본값으로 대체합니다.

전체 스타일 흐름 + MOTION_PHILOSOPHY 기본값: Read: references/style-intake.md


게이트 4 · 브리프 종합 (빌드 전 하드 게이트)

  1. MOTION_PHILOSOPHY.md를 읽으세요 – 워크스페이스 루트에 있으면 반드시 읽어야 합니다. 없으면 references/style-intake.md의 기본값을 진행하고 브리프에 부재 사실을 기록하세요.
  2. 프로젝트 위치가 명확하지 않으면 어디에 둘지 물어보세요:
    • video-projects/가 존재하면 → video-projects/<slug>/ 사용
    • 그렇지 않으면 → 사용자에게 물어보세요
  3. <project-folder>/BRIEF.md 작성:
    • 슬러그 · 의도 · 대상 · 치수 · fps · 길이
    • 스크립트 (전체 또는 개요)
    • 음성 선택 · 자막 계획 · 얼굴 카메라 계획
    • 스타일 프로필: 팔레트 (16진수), 폰트, 로고 경로, 참고 영상
    • 페이싱
    • 에셋 인벤토리 (경로 포함)
    • 아웃트로 / CTA 텍스트
  4. 브리프를 보여주세요. 명시적 승인을 기다리세요. "네, 빌드하세요"라는 명확한 확인 없이 게이트 5로 진행하지 마세요.

게이트 5 · 스캐폴드 및 스토리보드

먼저 인계 확인

브리프가 9:16 세로형 토킹헤드(얼굴 카메라 + 장면 오버레이)를 설명하는 경우, 지금 /short-form-video를 호출하고 브리프를 인계하세요. 4계층 스캐폴드는 해당 형식에 맞춰 제작되었습니다.

그렇지 않으면 계속 진행:

스캐폴드

  1. mkdir <project-folder>
  2. 비슷한 형식의 형제 프로젝트가 있으면 해당 hyperframes.json + meta.json을 템플릿으로 복사할 것을 제안하세요. 그렇지 않으면 폴더 내에서: npx hyperframes init
  3. 사용자의 슬러그, 치수, fps로 meta.json을 편집하세요.
  4. 제공된 에셋을 <project-folder>/assets/로 복사하세요.
  5. 게이트 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 – 필수)

  1. npx hyperframes lint – 모든 오류 수정, 경고 분류.
  2. 백그라운드에서 npx hyperframes preview 실행.
  3. http://localhost:3002에서 "Studio running" 메시지를 기다립니다.
  4. 사용자에게 URL 과 개별 컴포지션 URL (http://localhost:3002/?comp=<id>)을 전달합니다. 프로젝트에 WebGL 셰이더 블록이 있으면 개별 URL을 먼저 제시하세요 – 소프트웨어 WebGL 폴백이 마스터 컴포지션을 지연시킬 수 있습니다.
  5. 계속 진행하기 전에 명시적인 "좋아 보이네요, 드래프트 렌더링하세요" 확인을 기다리세요. 침묵은 승인이 아닙니다.

핫 리로드가 켜져 있습니다 – 편집 사항이 실시간으로 반영됩니다.


게이트 8 · 드래프트 렌더 → 시각적 검증 → MP4 미리보기 → 최종

드래프트 렌더

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

시각적 검증 (전달 전 필수)

린트 통과 ≠ 디자인 작동. 프레임을 추출하고 보세요.

  1. mkdir -p renders/frames
  2. 모든 비트의 핵심 순간과 모든 전환에 대해:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. 모든 PNG에 대해 Read 도구를 호출하세요. Read 도구가 이미지를 컨텍스트에 로드합니다 – 파일 이름만 나열하지 마세요.
  4. 프레임별로 확인: 잘린 얼굴 없음, 장면별 올바른 얼굴 모드, 텍스트 읽기 가능 및 팔레트 준수, 오버플로우 없음, 전환이 의도된 단어에 맞춰짐, 빈 프레임 없음.
  5. 문제가 있으면: 수정 → 재렌더링 → 재확인. 깨진 드래프트를 절대 출시하지 마세요.

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에서 인계

관련 스킬