Communitygithub.com

OXYGEN-CRO/adam-robinson-content-engine

브리프부터 스토리보드, 렌더링, 다중 에이전트 리뷰, 반복 개선을 거쳐 완성도 높은 제품 런칭 비디오를 Remotion으로 제작합니다. 15-30초짜리 소셜 클립(제품 출시, 기능 데모, 전후 비교)에 최적화되어 있습니다.

adam-robinson-content-engine란 무엇인가요?

이 스킬은 제품 출시 비디오 제작을 위한 반복 가능한 워크플로우를 제공합니다. Remotion을 기반으로 브리프 분석, 스토리보드 작성, 렌더링, 다중 에이전트 리뷰, 반복 개선 과정을 자동화하여 X, LinkedIn, YouTube Shorts, 랜딩 페이지 등에 최적화된 15-30초 클립을 제작할 수 있습니다. 주요 기능으로는 브랜드 토큰 추출, 실제 UI 화면 캡처 기반의 스토리보드, Remotion 컴포지션 커스터마이징, 프레임 단위 감사, 4명의 전문 비평 에이전트(디자인, 가독성, 내러티브, 브랜드 일관성)가 병렬로 리뷰하는 단계를 포함합니다. 플랫폼별 해상도와 길이 제한을 고려한 최종 렌더링까지 지원하며, 각 플랫폼용 MP4, GIF, 캡션 변형을 내보낼 수 있습니다. 잘못된 UI 라벨을 발명하지 않고 실제 앱의 복사본을 사용하는 것, 훅을 3초 이내에 배치하는 것, 비디오의 핵심 차별화 포인트에 가장 많은 화면 시간을 할당하는 것 등 실전 경험에서 얻은 교훈을 기반으로 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OXYGEN-CRO/adam-robinson-content-engine/tree/HEAD/raw/sources/2026-09-08-motion-quality/sources/EveryInc--product-launch-video/.claude/skills/product-launch-video

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

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

문서

제품 출시 비디오 워크플로우

Remotion을 사용하여 15-30초 제품 출시 비디오를 제작하기 위한 반복 가능한 워크플로우입니다. 기능 출시, 앱 데모, X, LinkedIn, YouTube Shorts 및 랜딩 페이지용 전후 변환에 적합합니다.

사용 시기

  • 제품 출시에 짧고 소셜 미디어에 적합한 비디오가 필요할 때
  • X/LinkedIn용 신규 기능 데모
  • 제품 전후 변환 클립
  • 랜딩 페이지 히어로 비디오

사전 요구 사항

  • Node.js 18+
  • 이 저장소를 클론하고 npm install을 실행했을 것
  • ffmpeg (GIF 내보내기 시에만 필요)
  • 제품 화면 녹화본 (30-60초, 디자인 영감으로만 사용)
  • 출시 카피: 헤드라인, 태그라인, 주요 기능, 톤 방향

워크플로우

1. 입력 수집 (병렬)

코드를 작성하기 전에 다음을 병렬로 수집하세요.

  • 브리프(brief) — 출시 포스트, 랜딩 페이지, 원페이지. 다음을 추출: 헤드라인, 태그라인, 주요 기능, 톤.
  • 브랜드 토큰 — 폰트, 색상, 아이콘, 로고. 디자인 시스템이 있다면 해당 값을 노출하세요. 그렇지 않으면 실제 제품에서 가져오세요.
  • 화면 녹화본 — 실제 사용 중인 제품의 30-60초 녹화. 이는 디자인 영감이자 실제 UI 복사본의 진실 공급원입니다. 실제 앱에 존재하지 않는 라벨, 에이전트 이름, 기능을 절대 발명하지 마세요.
  • 음성 보정(선택 사항) — 비디오에 나레이션이 포함되거나 특정 음성으로 캡션을 대필하는 경우, 최근 게시물/클립을 가져와 말투와 단어 선택을 일치시키세요.

2. 코드를 작성하기 전에 스토리보드 작성

샷 리스트 표를 작성하세요. 코딩을 시작하고 싶은 충동을 참으세요.

비트시간시각적 요소텍스트 오버레이

재렌더링을 방지하는 규칙:

  • 실제 제품 UI 복사본을 사용하세요. 실제 앱을 스크린샷하고 그대로 반영하세요. 발명된 라벨은 출시가 가짜처럼 느껴지는 #1 원인입니다.
  • 제품 이름이 아닌 시청자의 문제(훅)로 시작하세요.
  • 3초 이내에 제품이 등장해야 합니다 (a16z Speedrun 출시 비디오 연구).
  • 전후 비교가 핵심 장면입니다 — 전체 비디오를 이를 중심으로 디자인하세요.
  • 모든 텍스트는 720p에서 읽을 수 있어야 합니다 (휴대폰 피드). 최소 18px 상당.
  • 소셜 조회의 85%+는 음소거 상태입니다 — 모든 캡션을 비디오에 내장하세요. 명시적으로 요청되지 않은 경우 음성 해설(VO)은 사용하지 마세요.

3. Remotion으로 구축

이 저장소는 최소한의 Remotion 스캐폴드를 제공합니다. src/LaunchVideo.tsx에서 시작하여 커스터마이징하세요.

  • 컴포지션을 얇게 유지하세요 — 복잡성이 증가하면 씬, 테마, 폰트, 모의 데이터를 별도 파일로 추출하세요.
  • src/Root.tsx에 새 컴포지션을 등록하세요 (여러 플랫폼에 배포하는 경우 종횡비별로 하나씩).
  • public/의 에셋에는 staticFile()을 사용하세요.
  • 기본값은 1920×1080, 30fps, h264 crf 18입니다 — 플랫폼별 재정의는 출시 섹션을 참조하세요.

글꼴 로딩 패턴 (문자 잘림 및 레이아웃 깨짐 방지):

const [handle] = useState(() => delayRender('fonts'));
useEffect(() => {
  const font = new FontFace('Name', `url(${staticFile('fonts/file.otf')})`);
  font.load().then(f => { document.fonts.add(f); continueRender(handle); });
}, [handle]);

크로스페이드 전환 — 씬별이 아닌 오케스트레이터/루트 수준에서 처리하세요. 씬별 종료 페이드는 오케스트레이터와 충돌하여 이중 페이딩을 유발합니다.

4. 렌더링-감사 루프

# 단일 프레임 감사
npx remotion still <comp-id> out/test.png --frame 60

# 전체 렌더링
npx remotion render <comp-id> out/video.mp4 --codec=h264 --crf=18

먼저 각 씬의 한 프레임을 렌더링하세요. 전체 렌더링 전에 레이아웃/잘림 문제를 수정하세요. 다음을 확인:

  • 텍스트가 잘리지 않았는지 (descender가 있는 세리프 폰트의 경우 line-height >= 1.2)
  • 패널이 예기치 않게 쌓이지 않았는지 (AbsoluteFill은 기본적으로 flex-direction: column)
  • 버블, 카드 또는 채팅 UI에서 콘텐츠가 잘리지 않았는지

5. 다중 에이전트 리뷰 (모든 것을 잡아내는 단계)

2-3회의 자체 반복 후, ~20개 프레임(피크 순간 + 전환 프레임)을 out/review/에 렌더링하고 4개의 리뷰 에이전트를 병렬로 실행하세요. 각 에이전트는 PNG 프레임을 읽고 우선순위가 지정된 수정 목록을 반환합니다.

  1. 디자인/레이아웃 비평가 — 어긋난 요소, 정렬 불량, 비율, 크롭
  2. 텍스트/가독성 비평가 — 720p에서의 가독성, 대비, 잘림, 오타
  3. 내러티브/페이싱 비평가 — 스토리 아크, 주의 집중 피크/드롭, 획득한 지속 시간, CTA 강도
  4. 브랜드 일관성 비평가 — 실제 제품과 일치하는 폰트, 색상, UI 요소

4명의 비평가 출력물 + 자신의 메모를 모두 단일 수정 계획으로 컴파일한 후 다음 렌더링 패스로 진행하세요. 이 단계는 50번 렌더링 후에는 눈에 띄지 않는 문제를 찾아냅니다.

6. 피드백에 따라 반복

QuickTime(또는 선택한 플레이어)에서 렌더링을 보고 반복하세요. 일반적인 피드백 패턴과 수정 방법:

  • "이 텍스트가 잘렸어요" → line-height 또는 overflow 문제
  • "이게 어색해요" → 애니메이션 타이밍이 너무 빠르거나 느림; 카운터 숫자 깜박임 속도 확인
  • "이 라벨을 발명하셨네요" → 화면 녹화본의 실제 UI 복사본으로 교체
  • "여기서 좀 더 머물러 주세요" → 씬 지속 시간을 늘리고 애니메이션 타이밍은 동일하게 유지
  • "전체적으로 조금 깁니다" → 중복되는 씬을 잘라내세요 (보통 내러티브 비평가가 어떤 씬인지 식별함)

7. 올바른 플랫폼으로 출시

렌더링하기 전에 사용자가 어느 플랫폼에 게시할지 물어보세요. 종횡비와 길이 제한이 다릅니다. 16:9 클립을 포스트에서 9:16으로 자르면 일반적으로 보기 흉합니다. 비디오가 다른 종횡비를 가진 여러 플랫폼에 게시될 경우 각각에 대해 별도의 Remotion 컴포지션을 생성하고 독립적으로 렌더링하세요.

이 저장소의 기본값은 1920×1080 가로입니다. src/Root.tsx에서 치수를 변경하여 대상 플랫폼에 맞추세요.

플랫폼종횡비권장 크기최대 길이
X / Twitter (피드)16:91920×10802:20
X / Twitter (세로)9:161080×19202:20
LinkedIn (피드, 가로)16:91920×108010분
LinkedIn (피드, 정사각형)1:11200×120010분
YouTube (표준)16:91920×1080—
YouTube Shorts9:161080×192060초
Instagram 피드4:51080×135060초
Instagram Reels9:161080×192090초
TikTok9:161080×19203분

권장 전달물 패키지:

  • 요청된 각 종횡비의 MP4
  • 임베드 및 Slack 공유용 GIF 버전 (아래 렌더 명령어 참조)
  • 각 플랫폼용 캡션 변형 (길이 및 톤이 다름)
  • X 및 LinkedIn 답글용 스레드/기능 목록 버전

힘들게 얻은 교훈

  • 절대 제품 UI 라벨을 발명하지 마세요. 실제 앱을 스크린샷하고 복사본을 정확히 반영하세요. 이것이 출시 비디오가 어색해지는 가장 큰 원인입니다.
  • 오직 당신의 제품만이 제공할 수 있는 한 순간을 찾아 — 가장 많은 화면 시간을 할당하세요. 모든 출시 비디오에는 차별화되는 비트가 있습니다. 나머지 비디오는 이를 설정해야 합니다. 런타임을 기능 전체에 균등하게 분배하지 마세요.
  • 전후 비교는 동시보다 순차가 낫습니다. 먼저 "이전"을 0.7-1초 동안 보여준 후, 스프링 오버슈트와 색상 플래시와 함께 "이후"를 등장시키세요. 둘이 동시에 나타나는 것보다 훨씬 극적입니다.
  • 카운터 애니메이션: 자연스럽게 느껴지는 속도로 프레임당 숫자 속도를 일치시키세요. 더 큰 목표 숫자가 동일한 애니메이션 창에 들어맞아서는 안 됩니다 — 늘리세요.
  • 엔드카드: 하나의 헤드라인 + CTA. 3줄의 카피를 쌓지 마세요. 랜딩 페이지의 실제 태그라인을 사용하세요 — 더 멋지게 들리기 위해 당신이 발명한 것이 아니라요.
  • "문제 상태"를 시청자가 설명 없이도 인식할 수 있는 것으로 만드세요. 무슨 문제인지 이해하는 데 한 문장이 필요하다면 훅이 너무 추상적인 것입니다.

렌더 명령어

# 브라우저에서 미리보기 (핫 리로드 스튜디오)
npm run studio

# 단일 프레임 (가장 빠른 감사 방법)
npx remotion still <comp-id> out/frame.png --frame 60

# 전체 비디오
npx remotion render <comp-id> out/video.mp4 --codec=h264 --crf=18

# GIF (임베드용 — ffmpeg 필요)
ffmpeg -y -i out/video.mp4 \
  -vf "fps=15,scale=960:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=128[p];[s1][p]paletteuse=dither=bayer:bayer_scale=3" \
  out/video.gif

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬