Communitygithub.com

Poster Armory

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

Poster Armory란 무엇인가요?

Poster Armory는 AI 에이전트가 20년 경력의 모션 그래픽 디자이너이자 시각 마케팅 전문가 역할을 하여 전문적인 프로모션 비디오를 제작할 수 있게 해주는 스킬입니다. 이 스킬은 Remotion(React 기반 비디오 라이브러리)을 기반으로 하며, ElevenLabs 음성 합성, Pixabay 로열티 프리 음악, 그리고 고급 애니메이션 기술을 결합하여 완성도 높은 결과물을 제공합니다. Cursor, Claude Code, Codex와 같은 주요 AI 에이전트 플랫폼에서 작동하며, `git` 로그 분석 또는 사용자 설명을 통해 제품 컨텍스트를 이해한 후, 시각적 스타일, 전환 효과, 지속 시간을 맞춤 설정합니다. 워크플로는 크게 다섯 단계(제품 이해, 지속 시간 및 테마 설정, Remotion으로 빌드, 음성 해설 및 음악 추가, 최종 렌더링)로 구성되며, 오디오-비주얼 싱크를 위한 Whisper 검증, 중복 음성 해결, 다양한 반복 수정 옵션을 통해 품질을 보장합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/EvanGruhlkey/poster-armory/tree/HEAD/.agents/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
# models, controllers, services, 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/<프로젝트명>
cd promo-video/<프로젝트명>
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 사용 금지)

관련 스킬