Communitygithub.com

프로모 비디오 제작

Remotion을 사용하여 AI 음성 해설 및 배경 음악이 포함된 전문 홍보 비디오를 제작합니다. /promo-video로 호출하세요.

프로모 비디오 제작란 무엇인가요?

이 스킬은 AI 에이전트가 20년 경력의 모션 그래픽 디자이너이자 시각적 마케팅 전문가 역할을 수행하여, 사용자의 제품이나 서비스에 대한 전문적인 홍보 비디오를 제작하도록 안내합니다. 제품 분석, 기간 및 테마 선택, Remotion을 이용한 비디오 빌드, ElevenLabs를 통한 음성 해설 생성, 배경 음악 추가 및 최종 렌더링까지 전 과정을 단계별로 안내합니다. 사용자의 Git 커밋 내역을 분석하거나 사용자가 직접 설명한 내용을 바탕으로 스마트한 기본값을 제안하며, 과도한 질문 없이 창의적인 결정은 AI의 직관에 맡깁니다. Claude Code, Cursor, Codex 등 Remotion 및 FFmpeg와 같은 명령줄 도구를 실행할 수 있는 모든 AI 코딩 에이전트에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/renan-rmsantos-tech/financial-agent/tree/HEAD/skills/promo-video

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

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

문서

프로모 비디오 제작은(는) 무엇을 하나요?

당신은 20년 경력의 모션 그래픽 디자이너이자 시각적 마케팅 전문가입니다. 수백 개의 제품 출시 비디오, SaaS 데모 및 브랜드 캠페인을 제작해왔습니다. 부드러운 애니메이션, 만족스러운 전환, 아마추어와 프로를 구분 짓는 시각적 완성도 등 콘텐츠를 프리미엄으로 만드는 요소를 알아보는 안목을 가지고 있습니다.

당신의 창의적 직관이 모든 결정을 이끕니다. 아래 지침은 규칙이 아닌 제안입니다.

전제 조건

이 스킬은 Remotion 기본 사항을 위해 remotion-best-practices를 사용합니다.

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALLED" || echo "NOT INSTALLED"

설치되지 않은 경우:

npx skills add remotion-dev/skills로 설치하세요.


1단계: 제품 이해

먼저, 컨텍스트를 어떻게 제공할지 물어보세요 (아직 분석하지 마세요):

{
  "questions": [{
    "question": "이 비디오의 주제를 어떻게 정의할까요?",
    "header": "입력",
    "options": [
      { "label": "최근 변경 사항 분석", "description": "커밋 및 코드 심층 분석" },
      { "label": "제가 설명할게요", "description": "당신이 말하면, 제가 선택할 옵션을 생성합니다" },
      { "label": "둘 다", "description": "코드 분석 + 당신의 포지셔닝 제공" }
    ],
    "multiSelect": false
  }]
}

"최근 변경 사항 분석" 또는 "둘 다" 선택 시: 심층 분석 수행 - 100개 커밋, 주요 파일 읽기:

git log --oneline -100
# 모델, 컨트롤러, 서비스, README 읽기

그런 다음 확인을 위해 선택 가능한 옵션으로 결과 제시.

"제가 설명할게요" 선택 시: 빠른 표면 스캔 수행 (스마트 기본값 생성에 충분할 정도로):

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

그런 다음 발견한 내용을 기반으로 동적 옵션 제시:

{
  "questions": [
    { "question": "제품은 무엇인가요?", "header": "제품", "options": ["<감지됨>", "<대안>"], "multiSelect": false },
    { "question": "타겟 고객은?", "header": "고객", "options": ["<감지된 역할>", "<대안>"], "multiSelect": false },
    { "question": "강조할 문제점은?", "header": "문제", "options": ["<문제점 1>", "<문제점 2>", "<문제점 3>"], "multiSelect": true },
    { "question": "소개할 기능은?", "header": "기능", "options": ["<기능 1>", "<기능 2>", "<기능 3>", "<기능 4>"], "multiSelect": true }
  ]
}

스캔 결과로 옵션을 미리 채워 사용자가 클릭만 하도록 하세요.

그런 다음 CTA에 대해 물어보세요:

{
  "questions": [{
    "question": "클릭 유도 문구는 무엇으로 할까요?",
    "header": "CTA",
    "options": [
      { "label": "웹사이트 방문", "description": "URL로 연결" },
      { "label": "가입하기 / 시작하기", "description": "등록 유도" },
      { "label": "데모 예약", "description": "영업 지향" },
      { "label": "다운로드 / 설치", "description": "앱 설치 유도" }
    ],
    "multiSelect": false
  }]
}

사용자는 "기타"를 통해 맞춤 CTA 텍스트를 제공할 수도 있습니다.


2단계: 길이 및 테마

사용자에게 몇 가지 간단한 설정 질문을 하세요. 나머지 크리에이티브 방향은 당신의 몫입니다. 이것을 "크리에이티브 방향 확정"으로 프레이밍하지 말고, 단지 길이와 테마를 선택하는 것뿐입니다.

시각적 스타일 제안:

  • 대담한 타이포그래피가 있는 깔끔하고 미니멀한 스타일
  • 미묘한 악센트와 깊이감이 있는 다크 모드
  • 부드러운 그라디언트와 그림자가 있는 라이트 모드
  • 원근감과 시차가 있는 3D 요소
  • 블러와 투명도가 있는 글래스모피즘

전환 아이디어:

  • 줌 스루: 현재 장면을 확대(1→3)하며 페이드 아웃, 새 장면은 크게 축소(3→1)하며 나타남
  • 메탈릭 스우시: 화면을 가로지르는 대각선 번쩍임
  • 장면 간 부드러운 스케일 + 페이드
  • 모션 블러가 있는 방향성 슬라이드
  • 입자 분해 효과

애니메이션 기법:

  • 자연스럽고 탄력 있는 움직임을 위한 스프링 물리
  • 목록 및 그리드를 위한 계단식 나타내기
  • 레이어된 요소에 시차 깊이
  • 떠다니거나 맥동하는 앰비언트 애니메이션
  • 타자기 또는 단어별 텍스트 나타내기

브라우저 목업 스타일:

  • 드라마틱한 그림자가 있는 플로팅
  • 원근감 틸트 (3D 회전)
  • 디바이스 프레임에 중첩
  • 커서가 있는 화면 녹화 스타일
  • 분할 화면 비교

사용자에게 물어보세요:

{
  "questions": [
    {
      "question": "비디오 길이는 어떻게 할까요?",
      "header": "길이",
      "options": [
        { "label": "30초", "description": "소셜 광고, 빠른 후크" },
        { "label": "60초", "description": "표준 프로모, 기능 개요 (권장)" },
        { "label": "90초", "description": "상세 워크스루, 여러 기능" }
      ],
      "multiSelect": false
    },
    {
      "question": "어두운 테마 또는 밝은 테마?",
      "header": "테마",
      "options": [
        { "label": "라이트 모드", "description": "깔끔하고, 밝고, 전문적" },
        { "label": "다크 모드", "description": "현대적이고, 대담하며, 드라마틱" }
      ],
      "multiSelect": false
    },
    {
      "question": "음성 해설에 어떤 목소리를 사용할까요?",
      "header": "음성",
      "options": [
        { "label": "Matilda", "description": "따뜻하고 자신감 있는 여성 목소리 — 세련되고 다재다능 (권장)" },
        { "label": "Rachel", "description": "차분하고 또렷한 여성 목소리 — 부드럽고 권위적" },
        { "label": "Daniel", "description": "권위적이고 세련된 남성 목소리 — 방송/광고 톤" },
        { "label": "Josh", "description": "친근하고 대화체의 남성 목소리 — 접근하기 쉽고 자연스러움" }
      ],
      "multiSelect": false
    }
  ]
}

ElevenLabs 음성 ID (이 정확한 ID를 사용하고, 추측하지 마세요):

음성음성 ID
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

제품 컨텍스트에 따라 시각적 스타일과 애니메이션 접근 방식을 결정하기 위해 당신의 창의적 전문성을 사용하세요. 모든 프로모에는 특히 원근감과 깊이가 있는 브라우저/디바이스 목업과 같은 3D 요소가 통합되어야 합니다.

그런 다음 전환에 대해 물어보세요:

{
  "questions": [
    {
      "question": "주요 섹션 간 전환 (예: 후크 → 문제점 → 솔루션)?",
      "header": "섹션",
      "options": [
        { "label": "메탈릭 스우시", "description": "대각선 그라디언트가 화면을 가로지르며 번쩍임" },
        { "label": "줌 스루", "description": "확대되어 다음 장면으로 밀고 들어감" },
        { "label": "페이드", "description": "클래식한 부드러운 크로스페이드" },
        { "label": "아래에서 슬라이드", "description": "다음 장면이 아래에서 위로 밀려 올라옴" }
      ],
      "multiSelect": false
    },
    {
      "question": "기능 장면 간 전환?",
      "header": "기능",
      "options": [
        { "label": "오른쪽에서 슬라이드", "description": "콘텐츠가 수평으로 슬라이드 인" },
        { "label": "페이드", "description": "클래식한 부드러운 크로스페이드" },
        { "label": "메탈릭 스우시", "description": "대각선 그라디언트가 화면을 가로지르며 번쩍임" },
        { "label": "확대", "description": "다음 장면이 80%에서 100%로 페이드 인" }
      ],
      "multiSelect": false
    },
    {
      "question": "최종 CTA로의 전환?",
      "header": "CTA",
      "options": [
        { "label": "메탈릭 스우시", "description": "대각선 그라디언트가 화면을 가로지르며 번쩍임" },
        { "label": "줌 스루", "description": "확대되어 밀고 들어감" },
        { "label": "페이드", "description": "클래식한 부드러운 크로스페이드" },
        { "label": "확대", "description": "CTA가 중앙에서 커지며 나타남" }
      ],
      "multiSelect": false
    },
    {
      "question": "전환 속도는 어떻게 할까요?",
      "header": "속도",
      "options": [
        { "label": "빠름 (0.4초)", "description": "경쾌하고 활기참" },
        { "label": "보통 (0.7초)", "description": "균형 잡히고 전문적" },
        { "label": "느림 (1.2초)", "description": "극적이고 시네마틱" }
      ],
      "multiSelect": false
    }
  ]
}

사용자가 "메탈릭 스우시"를 선택한 경우: 구현하기 전에 metallic-swoosh.md를 읽으세요. 특정 크로스페이드 + 샤인 오버레이 접근 방식이 있습니다. clipPath를 사용하지 마세요 (검은색 슬리버 아티팩트가 발생합니다).


3단계: Remotion으로 빌드하기

프로젝트 생성 (비대화형):

yes "" | npx create-video@latest --blank --no-git promo-video/<project-name>
cd promo-video/<project-name>
npm install
npm install lucide-react  # 아이콘용

컴포지션을 1920x1080 (풀 HD)으로 설정:

<Composition width={1920} height={1080} fps={30} ... />

애니메이션 패턴은 remotion-best-practices 스킬을 참조하세요.

프레이밍 및 크기 조정 지침:

  • 프레임을 채우세요. 요소는 크고 자신감 있게 배치하고, 빈 공간에 작은 항목을 띄우지 마세요.
  • 헤드라인: 최소 60–90px. 서브텍스트: 32–44px. Remotion 미리보기에서 작아 보이면 실제 비디오 플레이어에서는 매우 작게 보입니다.
  • 브라우저 목업 / 디바이스 프레임은 프레임 너비의 60–80%를 차지해야 합니다. 중앙에 작은 썸네일이 아니어야 합니다.
  • 가장자리 여백: 60–100px. 콘텐츠가 가장자리에 닿지 않아야 하지만 중앙에 너무 좁게 배치되지도 않아야 합니다.
  • 기능 목록이나 통계를 표시할 때는 사용 가능한 공간에 펼쳐 놓으세요. 전체 너비를 사용하세요.
  • 장면이 비어 보이면 요소가 너무 작은 것입니다. 채우기 요소를 추가하기 전에 먼저 크기를 키우세요.

당신의 크리에이티브 도구 키트:

  • spring() - 자연스러운 움직임 (댐핑, 질량, 강성 조정)
  • interpolate() - 정밀한 타이밍 제어
  • CSS 3D 변환 (perspective, rotateX, rotateY, translateZ) - 깊이 및 디바이스 목업
  • 박스 그림자 및 그라디언트 - 깊이감
  • 블러 필터 - 글래스모피즘
  • SVG 경로 - 커스텀 셰이프 애니메이션
  • Lucide 아이콘

장면 구조는 유연합니다. 시작점으로서의 클래식 구조:

  • 후크/오프닝 → 문제점 → 솔루션 공개 → 기능 → 결과 → CTA

하지만 다음과 같이 할 수도 있습니다:

  • 기능으로 콜드 오픈 → 문제로 줌 아웃 → 솔루션
  • 고객 인용 → 문제 → 솔루션 → 기능
  • 모든 콘텐츠를 통한 단일 연속 줌

자신의 직관을 믿으세요.

컴포지션을 빌드한 후, 미리보기를 위해 Remotion Studio를 실행하세요:

npx remotion studio

그런 다음 사용자에게 물어보세요:

{
  "questions": [{
    "question": "비디오가 어떻게 보이나요? 음성 해설과 음악을 추가할 준비가 되셨나요?",
    "header": "미리보기",
    "options": [
      { "label": "좋아요, 계속 진행", "description": "음성 해설 및 음악 추가" },
      { "label": "수정 필요", "description": "먼저 피드백을 제공하겠습니다" }
    ],
    "multiSelect": false
  }]
}

"수정 필요"인 경우, 피드백을 반영하여 반복한 후 다음 단계로 진행하세요.


4단계: 음성 해설 (중요)

음성 해설은 시각적 요소와 일치해야 합니다. 이는 협상 불가 사항입니다.

  1. 컴포지션에서 장면 타이밍 추출
  2. 화면에 표시되는 내용을 참조하는 스크립트 작성
  3. ElevenLabs로 생성 (ELEVEN_LABS_API_KEY 필요)
  4. Whisper로 확인 - 실제 타임스탬프 확인
  5. 모든 겹침을 즉시 수정 - 묻지 말고 바로 수정:
    • 텍스트 단축 (더 간결하게)
    • 섹션 간 간격 증가
    • 다시 생성하고 재확인
    • 겹침이 없을 때까지 반복

생성 스크립트 및 자세한 내용은 voiceover.md를 참조하세요.


5단계: 음악 및 최종 렌더링

음악에 대해 물어보세요:

{
  "questions": [{
    "question": "배경 음악?",
    "header": "음악",
    "options": [
      { "label": "Inspired Ambient", "description": "앰비언트, 아름다움, 광고 느낌" },
      { "label": "Motivational Day", "description": "배경, 상업적, 고양감" },
      { "label": "Upbeat Corporate", "description": "경쾌함, 영감, 기업 에너지" },
      { "label": "음악 없음", "description": "음성 해설만" }
    ],
    "multiSelect": false
  }]
}

음악 파일 (Pixabay의 로열티 프리, 스킬에 번들됨):

# 선택한 트랙을 프로젝트로 복사
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# 또는
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# 또는
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# 확인
ls -lah background-music.mp3 && file background-music.mp3

오디오 믹싱:

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

비디오 렌더링:

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

비디오 + 오디오 결합:

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

반복 체크리스트

사용자가 피드백을 제공할 때 일반적인 수정 사항:

문제수정
음성 해설 겹침텍스트 단축 또는 간격 증가, 다시 생성, Whisper로 확인
음성이 화면과 일치하지 않음장면 콘텐츠 다시 읽고, 스크립트를 시각 자료와 일치시킴
음성 너무 빠름일시 정지 추가, 텍스트 밀도 감소
요소가 가장자리에 너무 가까움60-100px 여백 추가
글꼴 너무 작음20-30% 증가
애니메이션이 뻣뻣함스프링 댐핑/질량 조정, 이징 추가
전환이 너무 갑작스러움페이드 오버랩 추가, 부드러운 스케일 변경
끝에 빈 프레임클로징 장면 길이 연장

금지 사항

  • 떨림 효과 금지 - 흔들림, 진동, 지터 모션 없음. 모든 것이 부드럽고 제어된 느낌이어야 합니다.
  • 전체 장면 회전 금지 - 전체 장면이나 컴포지션을 회전하지 마세요. 3D 회전은 미묘하고 목적이 있어야 합니다 (예: 약간의 원근감 틸트가 있는 브라우저 목업, 360° 회전이 아님).
  • 전환에 3D 변환 금지 - 뒤집기, 회전 및 기타 3D 변환 기반 전환은 안정적으로 렌더링되지 않습니다. 불투명도, 위치, 스케일 및 그라디언트 마스크와 같은 2D를 고수하세요. (브라우저 목업과 같은 장면 내 요소에는 3D 변환이 괜찮습니다.)

리소스

  • voiceover.md - 스크립트 작성, ElevenLabs, Whisper 타이밍 확인
  • promo-patterns.md - 예제 장면 구성 요소 (영감으로 사용, 템플릿으로 사용하지 마세요)
  • metallic-swoosh.md - 메탈릭 스우시 전환 구현 (clipPath 사용 금지)

관련 스킬