듀얼 포맷 숏폼 비디오
하나의 소스에서 두 개의 MP4 파일—세로 1080×1920 및 가로 1920×1080—을 생성합니다. 음성 해설이 리듬을 결정하며, 모든 요소는 이에 종속됩니다.
시작하기 전에: 주제가 뉴스인 경우
대본을 한 줄이라도 쓰기 전에 웹 검색을 통해 사실을 확인하세요. 허위 데이터가 포함된 정보성 영상은 이 스킬의 최악의 결과물이며, 조용한 실패입니다. 영상은 여전히 예쁘게 나오니까요.
요청의 전제가 성립하지 않는다면, 그대로 말하고 실제로 일어난 일을 편집하세요. 거짓 전제에 맞추기 위해 대본을 '순화'하지 마십시오. 대본을 건드리기 전에 references/periodism.md를 읽으세요. 사실 확인, 정보성 콘텐츠의 이미지 처리, 그리고 추적 가능성 파일에 대해 다룹니다.
워크플로
npm run voz -- <slug> # script.json → assets/voice/*.wav + 타이밍 매니페스트
npm run imagenes -- <slug> # images.json → 생성형 B-roll
npm run stock -- <slug> # stock.json → 실제 사진 (선택 사항, 유료)
npm run audio -- <slug> # audio.json → 음악 및 효과음
npm run build -- <slug> # plan.json → vertical.html + horizontal.html
npm run use -- <slug> vertical
npm run check # 필수: 렌더링 전 오류 0개
npm run render -- <slug> # renders/<slug>-<format>.mp4
프로젝트가 아직 없는 경우: npx hyperframes@latest init . --non-interactive --example blank, 이 스킬의 scripts/와 assets/를 복사하고, package.json에 스크립트를 추가하세요. Node 22+ 및 ffmpeg가 필요합니다. .env에 키를 설정하세요 (템플릿은 assets/env.example에 있음).
구조
videos/_shared/vox.css, timeline.js 모든 비디오에서 공유
videos/<slug>/
script.json 대본 — 한 줄 = 한 컷
images.json 생성형 B-roll 프롬프트
stock.json 실제 사진 검색어
audio.json 음악 및 효과음
plan.json 편집 구성: 대본 줄을 참조하는 비트
scenes/*.html 일회용 애니메이션 서브-컴포지션
assets/ 생성된 파일 + 실제 타이밍 매니페스트
vertical.html, horizontal.html build.mjs에 의해 생성됨 — 직접 수정 금지
모든 것을 뒷받침하는 두 가지 아이디어
1. 대본이 시간을 결정합니다. voice.manifest.json은 각 줄의 실제 start와 duration을 제공합니다. plan.json의 비트는 초가 아닌 줄을 참조합니다. 절대 눈대중으로 길이를 추정하지 마세요. 대본을 바꾸고, 음성을 재생성하면 편집이 자동으로 재배치됩니다.
2. 셸은 아티팩트입니다. 수십 개의 컷을 두 포맷으로 수동 동기화하는 것은 불가능합니다. build.mjs는 동일한 plan.json에서 두 포맷을 생성하므로, 둘이 달라질 수 없습니다. 유일한 차이는 스테이지 크기입니다. plan.json을 편집하고 재구축하세요.
한 장면이 9:16과 16:9 모두에서 유효하려면: vw/vh/vmin으로 레이아웃하고 절대 px를 사용하지 마세요; 서브-컴포지션의 루트는 data-width/data-height를 가지면 안 됩니다 (박스는 호스트 슬롯이 결정합니다); 그리고 클래스가 아닌 #root로 스타일링하세요 — 컴파일러의 스코핑이 클래스를 버립니다. 축이 변경되는 레이아웃의 경우, @media (min-aspect-ratio: 1/1)을 사용하세요.
비트 유형
stat (상승 카운트 countTo가 있는 주요 수치) · compare (두 수치 비교) · title (킥커 + 헤드라인 + 리드) · quote (인용 + 출처) · photo (전체 화면 이미지, 그라데이션, 텍스트 및 크레딧 포함) · capture (전체 화면 스크린샷, 출처 포함, 주장의 증거) · scene (일회용 애니메이션 서브-컴포지션).
회사나 제품에 대한 비디오의 경우, 로고와 출처의 스크린샷이 결과를 크게 향상시킵니다. 둘 다 references/imagenes.md에 있습니다.
가장 흔한 디자인 오류: 레이블 캐러셀
텍스트 카드만으로 구성된 비디오는 아무리 좋은 타이포그래피라도 지루합니다. title과 stat이 연속으로 쌓이는 것을 발견하면, 해결책은 더 많은 텍스트가 아닙니다. 바로 의미 있는 움직임입니다.
assets/scenes/에는 SVG로 된 9개의 애니메이션 장면이 포함되어 있어 바로 적용할 수 있습니다: olas, puntos, barras, mapa, cierre, orbita (궤도를 도는 물체), precios (이전/이후 표), caida (백분율과 함께 하락), indice (막대 그래프 순위). 적합한 장면을 videos/<slug>/scenes/로 복사하고 데이터를 변경하세요. 세부 사항 및 성능 규칙은 references/escenas-animadas.md를 참조하세요.
번갈아 사용: 수치 → 사진 → 애니메이션 장면 → 인용 → 사진. 각 컷마다 프레이밍을 변경하세요 (kb: "in" / "out"으로 Ken Burns 효과를 번갈아 사용).
리듬
3분짜리 explainer에서는 비트당 2~6초, 숏에서는 0.8~2.5초. 각 비트는 다음 비트가 시작될 때까지 지속되며, 검은 프레임이 남지 않습니다. fromTo()로 진입하고, 절대 from()을 사용하지 마세요. 호스트가 seek할 때마다 장면을 다시 검색하며 from()은 동기화가 깨집니다.
감정이 담긴 음성
eleven_multilingual_v2는 태그를 무시합니다. 연기를 제어하려면 "modelId": "eleven_v3"를 사용하고, 인라인으로 소문자 태그를 대괄호 안에 넣으세요:
{ "id": "l19", "text": "[somber] 예순일곱 명이 사망했습니다." }
주제에 맞게 톤을 조정하세요 — 사망자가 있는 뉴스에서는 절대 [excited]를 사용하지 마세요. 태그 카탈로그, 설정, 그리고 태그가 큰 소리로 읽히지 않는지 확인하는 방법은 references/audio.md를 참조하세요.
확정하기 전에
npm run check는 오류 0개로 종료되어야 합니다. 그런 다음 비디오를 시청하세요. 프레임 추출 (ffmpeg -ss <t> -i <mp4> -frames:v 1) 또는 npx hyperframes snapshot --at 12,40,90을 사용하면 연락처 시트도 생성됩니다. 린터는 장면이 검은색인지, 텍스트가 벗어났는지, 사진이 설명과 다른지를 감지하지 못합니다.
참고 자료
references/hyperframes.md— 렌더를 조용히 깨뜨리는 프레임워크 제약사항. 작곡을 쓰기 전에 읽으세요.references/audio.md— ElevenLabs: v3 태그 음성, 음악, 효과음, 트랙.references/imagenes.md— gpt-image-2 및 Apify, 비용 관리 포함.references/periodismo.md— 뉴스에서 사실 확인 및 이미지 처리.references/escenas-animadas.md— 9개의 SVG 장면, 새 장면 만드는 방법, 하루를 날릴 수 있는 두 가지 함정 (vox.css와의 클래스 충돌, GSAP이 SVGtransform을 덮어쓰는 문제).references/sistema-visual.md— explainer 스타일의 팔레트 및 타이포그래피.