Communitygithub.com

Demo Video Creator:產品網址直出 16:9 發表片

把一個產品網址做成約 60 秒的橫式發表成片:真實介面錄影、真實產出畫面、一條連貫旁白、對準節拍的 HyperFrames 動態、衝擊特效,最後輸出 -14 LUFS 的 mp4。支援英文與韓文。

Demo Video Creator:產品網址直出 16:9 發表片 是什麼?

影片在地化配方第 1 步(先做母版片),來自 chacha95/demo-video-creator(2026-10-07 發布,README 附英文與韓文樣片)。貼上產品網址後依序進行:需求 → 參考規格 → 含旁白台詞的 SCRIPT.md → DESIGN.md → 真實介面與產出畫面擷取 → ElevenLabs 一次錄完的旁白 → 配樂 → 以旁白為主、對準節拍的 HyperFrames 建構 → 改影格率重新算圖加速 → 衝擊特效與分層音效 → 品檢(動態、條帶圖、同步表、終檢)→ 一個 1920×1080、-14 LUFS 的 mp4。開頭一次檢查金鑰與工具,之後自主完成,決策記在 DECISIONS.md。不做 9:16 直式短影音。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chacha95/demo-video-creator/tree/HEAD/skills/demo-video-creator

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Demo Video Creator

약 60초 길이의 가로형 제품 데모/런칭 영상을 제작합니다. 사용자가 승인한 모션 느낌을 반영합니다. 최종 결과물은 하나의 mp4 파일입니다.

이 스킬이 존재하는 이유: 사용자는 이 느낌에 도달하기 위해 오랜 시간 반복 작업을 거쳤으며, 아래의 거의 모든 규칙은 사용자가 직접 수정한 사항입니다. 에이전트가 방치되면 동일한 실수(훅 없는 인트로, 웹사이트 스크린샷, 잘린 나레이션, 늦은 자막, 조잡한 크롭, 모든 단어에 트레일러 SFX)로 되돌아갑니다. "이유" 노트를 읽어 새 제품에 의도를 적용할 수 있도록 하세요. 단순히 Eval 결과를 복사하지 마세요.

이 머신에서 승인된 참고 자료 (제작 전 시청 필수):

  • videos/evals-hype/renders/evals-ref2-short-fast2-impact.mp4: 모션 느낌 ("모션이 좋단다").
  • videos/evals-demo2/: 훅, 연속적인 나레이션, 나레이션 기반 편집 및 마무리 패스를 포함합니다. SCRIPT.md, DESIGN.md 및 qa/finish.md는 "완료" 상태가 어떤지 보여줍니다.
  • 해당 경로가 존재하지 않는다면(새로 설치한 경우), 게시된 샘플 영상(demo_en.mp4, demo_ko.mp4)을 대신 사용하세요: https://github.com/chacha95/demo-video-creator/tree/main/media. references/examples/에는 일치하는 SCRIPT 및 DESIGN 문서가 있습니다.

자율적으로 작업하세요. 사용자는 하나의 요청을 붙여넣고 하나의 영상을 받기 원합니다. 사용자는 세션이 입력을 요구하기 위해 중단될 때 불만을 표시했습니다 ("인풋 요구해서 안되는데"). 합리적인 결정을 내리고 DECISIONS.md에 기록한 후 mp4가 생성될 때까지 계속 진행하세요.

0. 온보딩: 키 및 도구 (1단계 전에 한 번 확인)

이 순간만 유일하게 멈추고 질문할 수 있습니다. 시작할 때 모든 것을 한 번에 확인하고, 모든 누락 사항을 하나의 메시지로 보고한 후, 수정되면 자율적으로 실행하세요. 절대 파이프라인 중간에 묻지 마세요.

확인:

grep -q '^ELEVENLABS_API_KEY=.' .env 2>/dev/null || [ -n "$ELEVENLABS_API_KEY" ] && echo "key ok" || echo "ELEVENLABS_API_KEY missing"
H=$(mktemp); chmod 600 "$H"   # 키는 헤더 파일을 통해 전달되며, 명령줄에 직접 입력되지 않습니다.
printf 'xi-api-key: %s\n' "${ELEVENLABS_API_KEY:-$(grep '^ELEVENLABS_API_KEY=' .env | cut -d= -f2-)}" > "$H"
curl -s -o /dev/null -w "%{http_code}\n" -H @"$H" https://api.elevenlabs.io/v1/user; rm -f "$H"   # 200 = 유효
which ffmpeg node npx whisper-cli; node -e "require.resolve('playwright')" && echo "playwright ok"

절대 채팅이나 로그에 키 값을 출력하지 말고, 명령줄 인자에 사용하지 마세요(위와 같이 -H @file 사용).

키가 없거나 200 응답이 아닌 경우, 사용자에게 (한국어로 작성한다면 한국어로) 키 획득 방법을 알려주세요.

ElevenLabs API 키가 필요해요 (나레이션 + 배경음악 생성용)

  1. https://elevenlabs.io 에 로그인하세요. 음악 생성(Music)은 유료 플랜이 필요할 수 있어요.
  2. 왼쪽 아래 프로필 → Developers / API Keys → Create API Key.
  3. 권한에서 Text to Speech, Music, **Voices (read)**를 켜고 만드세요. 키는 한 번만 보여요.
  4. 프로젝트 루트의 .env 파일에 한 줄 추가하세요 (파일이 없으면 새로 만드세요): ELEVENLABS_API_KEY=여기에_키
  5. 채팅에 키를 붙여넣지 마세요. 저장했다고만 알려주시면 이어서 진행할게요.

.env 파일은 git에 추적되지 않습니다. 커밋하거나 키를 다른 곳에 복사하지 마세요.

도구 누락 시: brew install ffmpeg whisper-cpp (whisper-cli는 로컬 Whisper QA 패스를 다루며 키가 필요 없음), Node 20+, 그 후 npm i -D playwright && npx playwright install chromium.

파이프라인

brief → reference SPEC → SCRIPT.md (+VO lines) → DESIGN.md → assets (real UI + real outputs)
→ VO (one take) → music → build (HyperFrames, VO-led, beat-locked) → render at fps 30/speedup
→ post (retime, impact FX, mix) → QA (motion, strips, sync table, finish audit) → renders/<name>.mp4

프로젝트: videos/<name>/ 디렉토리 내에 SCRIPT.md DESIGN.md DECISIONS.md index.html build/ capture/ assets/ audio/ scripts/ qa/ renders/ 포함.

도구 관련 참고 사항:

  • 렌더링: 프로젝트 디렉토리에서 npx --yes [email protected] render -o <out> --quiet --fps 95/4 실행. 구성 계약이 익숙하지 않다면 hyperframes-core 스킬을 읽어보세요.
  • HTTP: curl 사용. 여기서 Python은 SSL 인증서가 없습니다.
  • 키: .env 파일(저장소 루트에 위치) (ELEVENLABS_API_KEY). 이 스킬의 모든 경로는 저장소 루트를 기준으로 합니다. 아래 온보딩 참조.
  • 번들된 헬퍼는 scripts/ 디렉토리에 있습니다 (끝 부분에 목록 참조).

1. 참고 자료 → SPEC.md

사용자가 참고 영상을 제공하면 다운로드하여 (watch 스킬 또는 yt-dlp) 프레임 단위로 측정합니다. 제공하지 않으면 위에서 승인된 영상을 측정합니다. 기록할 항목:

  • 컷 프레임, 샷 길이, 10초당 컷 수
  • 카메라 곡선 및 이징 (프레임당 남은 거리의 분수)
  • 타자 속도, 단어 공개 간격, 악센트 플래시 길이
  • 카드 연출 및 밝음↔어두움 전환
  • 각 사운드가 해당 컷 기준으로 위치하는 지점

그런 다음 해당 리듬으로 재구성하고 브랜드, 카피, 디자인 및 에셋만 변경합니다.

이유: 느낌은 숫자(프레임당 이징, 샷당 비트)에 있습니다. 에이전트가 형용사로 작업할 때 사용자는 "감도가 낮아" 또는 "모션이 어색해"라고 말했습니다. 측정된 숫자를 일치시켰을 때 승인되었습니다.

2. 스크립트

  • 3초 안에 스스로 설명하는 훅. 동일한 프롬프트의 실제 출력물을 나란히 재생하며 시작하고 제품이 답하는 질문을 합니다 (Evals의 경우: "Which one is better?"). 비트에 맞춰 A/B/C/D를 뒤집은 후 반전을 제공합니다 ("Same prompt. Different setups.").
    • 이유: 추상적인 오프너(모델 이름 나열 및 스킬 카운터)는 "뭐 어쩌라는건지 모르겠어"라는 반응을 얻었습니다. 시청자는 문제를 읽는 것이 아니라 직접 보아야 합니다.
  • 하나의 실제 작업을 처음부터 끝까지 따라갑니다. 입력 → 구성 → 실행 → 결과를 나란히 → 선택 → 증거(기록/세부사항) → 집계(리더보드/통계) → 커뮤니티 → URL이 포함된 엔드 카드.
  • 정적인 웹사이트가 아닌 움직이는 출력물을 보여주세요. 게임, 비디오, 3D 장면 및 숏츠는 데모에서 장관으로 읽히지만, 랜딩 페이지 스크린샷은 지루하게 읽힙니다 ("웹사이트 보여주지 말고 영상이나 게임"). 제품이 웹 페이지만 만든다면 정적 캡처가 아닌 움직이는 상태(스크롤, 상호작용)로 보여주세요.
  • 카피. 화면의 문구는 2–5단어입니다. 나레이션 스크립트는 60초에 약 165–180단어(약 2.7단어/초)여서 음성이 조용해지지 않습니다.
  • 진실. 자신의 캡처에 나타난 기능, 이름 및 숫자만 보여주세요. 실제 사람의 초상은 사용하지 마세요. 제품이 할 수 없는 것을 보여주는 데모는 데모가 없는 것보다 나쁩니다.

3. 디자인

DESIGN.md를 한 번 작성하고 모든 샷이 이를 따르도록 합니다. 다음을 설정합니다:

  • 작은 태그용 모노와 함께 하나의 산세리프 패밀리
  • 프레임당 하나의 악센트
  • 하나의 고정 여백(예: 120px)에 왼쪽 정렬된 헤드라인, 모든 곳에서 동일한 태그→헤드라인 간격
  • 부드러운 계층적 그림자가 있는 둥근 카드(16–22px)로 표시된 실제 UI
  • 어두움/밝음 섹션 전환

references/examples/에는 "Signal"(흑연/종이, 파란색) 및 "editorial"(크림/잉크, 산호)의 두 가지 완전한 시스템이 있습니다. 사용자가 새 영화를 요청할 때 기존 시스템을 재사용하지 말고 새 시스템을 디자인하세요. 사용자가 명시적으로 "시나리오랑 디자인만 다르게"를 요청했기 때문입니다.

4. 에셋 (실제, 신선, 선명)

  • UI: 4× DPR로 Playwright 캡처하므로 요소가 소스 픽셀보다 크게 표시되지 않습니다 (2× 캡처는 흐릿해 보였습니다). 전체 요소만 포함하는 크롭을 잘라냅니다. 크롭에 컨텍스트가 필요한 경우, 인접한 행을 남기는 대신 UI 자체의 채우기 색상으로 카드 배경을 다시 만듭니다.
  • 출력물:
    • scripts/rec_output.mjs <url> <out.mp4> 7 game|orbit (화면 캡처; 키를 누르거나 궤도 이동하여 출력물이 움직이도록 함).
    • 화면 캡처가 프레임을 반복할 때 scripts/rec_scroll.mjs (프레임당 하나의 스크린샷).
    • 사용 전 중복 프레임을 제거하세요. 반복된 프레임은 미세한 끊김으로 나타나 모션 QA에 실패합니다.
  • 동일 프롬프트 결과: 스토리가 "N 설정"을 말하는 경우, 동일한 프롬프트/실행에서 N개의 결과를 보여줍니다. 실제 실행이 필요한 경우 사용자의 로그인된 Chrome에서 제품 내에서 실행하세요. 관련 없는 출력물을 하나의 프롬프트 결과로 보여주면 "결과가 다 다르잖아"라는 반응을 얻었습니다.
  • 로고: 브랜드 로고 순간이 필요한 경우, 실제 브랜드 SVG를 실제 3D(three.js SVGLoader → ExtrudeGeometry, PBR 재질, 환경 조명, 알파 WebM)로 렌더링하여 사용하세요. 평면 CSS 로고 전환은 싸 보였습니다 ("짜친다").

5. 나레이션: 하나의 연속 테이크

  • 음성: bIHbv24MWmeRgasZH58o, eleven_v4, 안정성 0.15, 유사도 0.8, 스타일 0.8, 속도 ~1.1.
  • 인라인 감정 태그: [excited] [confident] [curious] [emphatic] [quick].
  • 이 음성을 선택한 이유: 사용자는 기본 내레이터를 "너무 아재 목소리"라며 거부했습니다. 힙하고 에너제틱한 느낌(Sam Altman / Elon 분위기)을 원했고, 대안을 들어본 후 이 최대 감정 설정을 선택했습니다.
  • 생성: scripts/vo3_gen.py (한 번의 /with-timestamps 호출). 테이크, 라인별 세그먼트 및 단어 타임스탬프를 작성합니다.
  • 전체를 배치합니다. 약 0.25초부터 시작하여 테이크를 하나의 연속적인 조각으로 배치합니다. 구절로 자르거나, 비트에 분산시키거나, 조각을 시간 늘리기 하지 마세요.
    • 이유: 구절을 자르면 음절이 누락되었습니다 ("소리 짤려").
    • 분산시키면 침묵이 발생했습니다 ("목소리가 중간에 죽잖아 … 쭉 이어지게").
    • 라인별 재합성은 음량이 일정하지 않았습니다.
    • 라인을 변경해야 한다면 전체 테이크를 다시 생성하세요.
  • 확인:
    • VO 내부의 간격이 ≤0.35초입니다.
    • 최종 믹스에 대한 Whisper 검사에서 잘린 단어나 음성 태그가 없습니다.
    • "Evals"가 "evils"처럼 들리면 "E-vals"로 다시 철자하세요.
  • 한국어 버전: ZNSVYmudV9pOqphY0x8C, 동일한 태그 및 설정. 제품의 영어 UI 용어는 VO와 텍스트 모두 그대로 유지하세요 (Task, Setup, Battle, Model, Skill, Environment). 사용자는 사이트 자체 용어를 원합니다 ("사이트에서 쓰이는 영어 용어는 그대로"). 모든 한국어 글리프에는 Pretendard를 사용하세요.

6. 음악

  • 만들어야 할 것: 현대적이고 프리미엄한 배경음악. 재고 EDM 라이저와 기업 분위기는 "촌스러"로 읽힙니다.
  • 방법: ElevenLabs Music으로 2–3개의 후보를 생성하세요. 프롬프트 예: "modern minimal tech launch, punchy kick, deep 808, crisp hats, glassy plucks, Apple/Linear keynote, no cheesy risers, no stock vibe, 120 BPM". 가장 깔끔한 것(중저음 클러터가 적은)을 선택하세요.
  • 적합:
    • scripts/beats.py / bars.py는 BPM과 첫 번째 다운비트를 제공합니다.
    • scripts/music_fit.py는 트랙을 소절 수준으로 재배열하여 브레이크와 드롭이 스토리 비트에 맞도록 합니다.

7. 빌드 (VO 기반, 비트 잠금)

  • 하나의 일시 중지된 GSAP 타임라인을 사용하며, 완전히 결정적입니다. 각 샷은 자체 로컬 시간으로 실행됩니다.
  • 편집은 음성을 따릅니다. 각 샷 변경은 해당 구절의 첫 번째 단어 바로 앞 또는 그 비트에 위치합니다. 더 일찍 반올림하고, 절대 늦지 않게 하여 단어가 도착할 때 그림이 준비되도록 합니다.
  • 동기화: 각 화면 단어는 발화되기 0.05–0.20초 전에 나타나며, 테이크의 단어 타임스탬프에 의해 구동됩니다.
    • 이유: 음성을 뒤따르는 텍스트는 "싱크가 안맞아"로 느껴졌습니다. 1초 전체의 리드는 텍스트와 음성이 분리되어 "너무 느린데"로 느껴졌습니다.
    • 작은 리드는 완벽하게 동기화된 것으로 읽힙니다.
    • scripts/sync_audit.mjs로 모든 라인을 감사하고 표를 유지하세요 (text_on, voice_on, lead).
  • 모션 문법: references/MOTION_RULES.md에 있습니다. 전체를 읽으세요. 핵심:
    • 시간의 순수 함수인 하나의 카메라
    • 스냅(프레임당 남은 거리의 약 25%) 또는 플로티(약 12%) 이징만 사용
    • 종료는 컷으로 가속되고 다음 샷은 속도를 상속받음
    • 두 샷이 속도 블러와 함께 함께 이동하는 실제 휩
    • 화면에 잠긴 오버레이
    • 중첩 액션
    • 모든 홀드는 1–3% 미세하게 움직임
    • 정지 없음, 동결 프레임 없음, 이중 컷 없음
    • 비트 ±1 프레임 내에서 컷
  • 한 방향으로 줌. 요소 안으로 확대한 다음 다시 풀지 마세요 ("줌 인 했다가 왜 다시 풀어"). 푸시는 다음 샷으로 전진하여 해결되어야 합니다.
  • 구성 순간은 움직여야 합니다. VO가 설정(예: "Model. Skill. Environment.")을 언급할 때, 각 발화 단어에 맞춰 실제 UI 값이 뒤집어지는 것을 보여주고 속도를 다음 히트로 전달하세요. 거기서 정적인 카드는 "감도가 낮아"로 읽혔습니다.

8–9. 렌더링 및 후반 작업

  • 속도: 프레임 드롭이 아닌 재렌더링으로 수행합니다. --fps 95/4 (1.263×)로 렌더링하거나, 한 비트가 정수 프레임과 같도록 30/speedup을 선택하세요. 30fps로 재생합니다.
  • 후반 작업: scripts/post_template.py를 복사하고 NF, BIG, MED, FLASH, VO_OFF를 설정합니다. 처리 내용:
    • 30fps로 리타이밍
    • 4–6개의 큰 히트에 임팩트 FX: +8.5% 줌 펀치 (τ 0.09), 16px 셰이크 ~22Hz (τ 0.1), 4프레임에 걸쳐 16px→7px RGB 분할, 1–2프레임 흰색 플래시
    • 보조 컷에는 더 가벼운 버전
    • 믹스 및 음량
    • 히트가 적은 이유: 모든 컷에 임팩트를 적용하면 임팩트로 읽히지 않습니다.
  • 믹스:
    • VO 약 −16 LUFS, 앞쪽.
    • 음악은 음성 아래에서만 약 4–6dB 덕킹되며, 부드러운 엔벨로프(약 50ms 어택, 0.6s 릴리스).
    • SFX 버스는 음악보다 약 3dB 낮춤.
    • 큰 히트에서 역 스웰 + 붐 (HP 60Hz) + 트랜지언트 + 글리치 레이어.
    • 다른 곳에서는 실제 UI 액션(타이핑, 클릭, 틱)에만 SFX를 넣습니다. 모든 단어에 트레일러 슬램은 "안어울리는거"로 제거되었습니다.
    • 마스터 −14 LUFS, AAC 192k. scripts/mixcheck3.py로 확인하세요.

10. 전달 전 QA

  1. python3 scripts/motion.py <mp4> <bpm> <first_beat>: 비트에 맞춘 컷, 정지 없음, 동결 홀드 없음. 푸티지 자체에서 발생하는 예외는 설명하세요.
  2. sh scripts/strip.sh <mp4> <t> <out.png> (연속 16프레임)을 모든 전환에서 실행하고 각각을 확인하세요. 연락처 시트(약 2초마다 한 프레임)는 모션이 끊겨도 깔끔해 보이기 때문에, 이전에 잘못된 모션이 배송된 원인이 되었습니다.
  3. 모든 VO 라인에 대한 동기화 표: 리드는 0.05–0.20초여야 합니다.
  4. 마감 감사 ("미감 높게 디테일한 마감"): 모든 샷의 시작, 중간, 끝에서 전체 해상도 스틸을 추출하고 가장자리와 모서리를 검사합니다. 각 문제와 수정 사항을 qa/finish.md에 기록하세요. 다음을 확인합니다:
    • 잘린 아이콘 또는 텍스트
    • 카드 가장자리의 부분적인 UI 행 또는 구분선
    • 스크롤바
    • 과도하게 확대된 스테이지의 회색 띠
    • 푸티지 HUD 위에 있는 레이블
    • 흐릿한 업스케일
    • 고르지 않은 패딩
    • 카드 가장자리에 닿는 텍스트
    • 샷 간에 표류하는 헤드라인 여백
    • 사용자는 단일 프레임에서 반쯤 잘린 종이 클립 아이콘과 카드 모서리의 구분선을 발견했습니다. 그러니 모든 것을 볼 것이라고 가정하세요.
  5. 최종 믹스에서 Whisper를 한 번 실행하고 음량이 −14 LUFS ±0.5임을 확인하세요.

사용자가 거부한 사항 (다시 도입하지 마세요)

거부된 사항사용자의 말
밑줄 / 밑줄 스트로크"밑줄 긋는거 하지마"
단어 뒤의 컬러 하이라이트 박스"백그라운드 컬러 넣어서 효과 주는거 빼줘"
행 체크 막대"갈색 띠 없애줘"
외곽선, 헤어라인 박스, 규칙, 저렴한 그라데이션, 이모지, 가짜 UI 목업—
0.1초 푸티지 스트로브, 섹션 사이의 갑작스러운 전체 화면 푸티지"영상 막 쏟아져 나오는거", "갑자기 다른 화면"
영화와 분리된 어두운 독립형 인트로"짜친다"
로고 아래의 텍스트 레이블"글씨는 없애줘"

전달 후

  • 사용자가 재생 속도(1.05× / 1.1×)를 요청하면 적용하세요.

相關技能