Reels 템플릿
15개의 데이터 기반 Remotion 템플릿(1080x1920, 60fps)이 이 스킬의 assets/reels-kit/ 폴더에 포함되어 있습니다. 하나의 동영상은 하나의 JSON 작업 파일입니다. 템플릿을 선택하고, 속성을 채우고, 렌더링하세요. 일반 작업에서는 React를 작성할 필요가 없습니다.
아래 경로 중 reels/로 시작하는 경로는 이 스킬 폴더가 아닌 작업 폴더를 가리킵니다. 작업 중에는 스킬 폴더 내의 파일을 절대 편집하지 마세요.
무인 실행. 이 스킬은 자율 에이전트용으로 제작되었습니다. 요청자는 작업을 시작한 주체(오케스트레이션 에이전트, 파이프라인, 또는 사람)입니다. 이 파일의 규칙에 따라 모든 결정을 내리고, 단계 승인을 위해 절대 멈추지 마세요. 해결할 수 없는 차단 요소(도구 누락, 미디어 없음 또는 읽을 수 없음, 계속 실패하는 렌더링)가 있을 때만 멈추고 보고하세요. 모든 작업은 보고서(섹션 4)로 끝납니다.
0. 작업 공간 설정
프로젝트당 한 번, 첫 번째 작업 전에 수행하세요.
- 도구를 확인하세요: Node.js 18 이상(
node -v),ffmpeg및ffprobe가 PATH에 있어야 합니다. 하나라도 없으면 멈추고 차단 요소로 보고하세요. 시스템 소프트웨어를 직접 설치하지 마세요. - 작업 폴더에 이미
reels/render.mjs가 있으면 해당 작업 공간을 사용하고 섹션 1로 건너뛰세요. - 그렇지 않으면 이 스킬의
assets/reels-kit/폴더를 작업 폴더의reels/로 복사한 다음(예:cp -R <skill-dir>/assets/reels-kit reels),reels/안에서npm install을 실행하세요. reels/public/(미디어) 및reels/jobs/_local/(임시 작업) 폴더를 만드세요. 작업 폴더가 git 저장소라면reels/node_modules/,reels/public/,reels/out/,reels/exports/및reels/jobs/_local/을.gitignore에 추가하세요.
작업 공간에는 render.mjs(작업 렌더링), clean.mjs(디스크 공간 확보, 섹션 6 참조), src/(템플릿 및 공유 키트), jobs/examples/(템플릿당 예제 작업 1개), public/<name>/(각 작업의 입력 미디어), out/stills/(QA 스틸) 및 exports/<name>/(각 작업의 완성된 비디오)가 포함됩니다.
선호도
이 저장소에는 개인의 취향이 담겨 있지 않습니다. 텍스트 스타일, 글꼴, 강조 색상, 카피의 어조, 언어, 음악 및 선도할 형식은 요청자의 브리프와 브랜드에 대해 이미 알고 있는 정보에서 비롯되며, 템플릿이나 이 파일에 기록된 값에서 비롯되지 않습니다. 브리프에 선호도가 명시되어 있으면 작업 파일에 적용하세요. 명시되어 있지 않으면 템플릿 기본값을 사용하고 보고서에 나열하세요. 개인이나 브랜드의 선호도를 템플릿, 예제 작업 또는 이 스킬에 기록하지 마세요.
1. 템플릿 선택
비디오가 누군가가 게시한 것처럼 느껴져야 할 때는 소셜 네이티브 세트로 시작하세요. 푸티지 자체가 비디오의 메시지를 전달할 때는 광고 세트를 사용하세요.
소셜 네이티브 (시청자가 이미 알고 있는 인터페이스가 훅)
| 템플릿 | 사용 시기 | 필요 항목 |
|---|---|---|
ChatStory | 문자 메시지 스레드로 전개되는 이야기, 그 다음 제품 공개 | 메시지 (+ 보낼 제품 사진), 보상 클립 |
NotesList | 스스로 입력되는 메모 앱 목록: "실패한 선물 vs 그녀가 간직한 선물" | 제목 + 1~7줄, 보상 클립 |
SearchHook | 고객의 질문이 검색창에 입력되고, 푸티지가 답변 | 질문 (+ 제안), 1개 이상의 클립 |
NotificationStack | 잠금 화면이 주문, 메시지, 리뷰로 가득 참: 사회적 증거 및 FOMO | 1~6개의 알림, 배경, 보상 클립 |
PolaroidDump | 손글씨 캡션이 있는 스크랩북 사진 덤프 | 2~8장의 사진 |
Ranking | 블라인드 랭킹: 항목이 번호 목록에 떨어짐, #1이 마지막 | 2~6개의 클립, 각각 레이블 및 순위 |
PollSticker | 푸티지 위의 스토리 투표: 두 가지 옵션, 탭, 결과 | 질문, 백분율이 있는 2개의 옵션, 클립 |
광고 형식 (푸티지 우선, 텍스트 위에)
| 템플릿 | 사용 시기 | 필요 항목 |
|---|---|---|
BeatCutAd | 푸티지에서 잘라낸 제품 광고 기본값: 여러 샷, 훅, CTA | 1개 이상의 비디오 클립 |
UgcCaptions | 사람이 카메라를 보고 말함; 단어별 캡션 | 음성 + 단어 타이밍이 있는 1개의 클립 |
Listicle | "3가지 이유", 팁, 기능, 단계 | 2~7개의 클립, 각 포인트당 하나 |
BeforeAfter | 변형 또는 비교 (mode: wipe 또는 split) | 2개의 클립 또는 사진 |
ProductSlideshow | 제품 사진만 있거나 빠른 카탈로그; 선택적 가격 스티커 | 2개 이상의 사진 또는 클립 |
Testimonial | 사회적 증거: 별표가 있는 리뷰 카드 | 1개의 배경 클립 + 리뷰 텍스트 |
CommentReply | 반론 또는 FAQ에 답변; 댓글 버블이 훅 | 1개 이상의 클립 + 댓글 |
OfferPromo | 세일, 할인 코드, 마감일 | 1개 이상의 클립 + 혜택 |
브리프가 이 중 어느 것에도 맞지 않으면 섹션 7을 참조하세요. 템플릿을 본래 목적에 맞지 않게 억지로 사용하지 마세요.
공식 Remotion 스킬(remotion-best-practices, npx skills add remotion-dev/skills --skill remotion-best-practices로 별도 설치)은 Remotion 코드 작성의 참고 자료입니다. 설치되어 있지 않으면 https://www.remotion.dev/docs 의 Remotion 문서를 대신 사용하세요. 이 저장소에서 비디오를 만들 때는 이 스킬이 차이가 있을 때 우선합니다: 새 프로젝트나 구성을 만드는 대신 작업 파일을 빌드하고, Studio를 여는 대신 스틸을 확인하고, 스틸이 통과하면 요청을 기다리지 않고 render.mjs로 렌더링합니다.
2. 작업 빌드
- 작업 이름을 선택하세요(소문자, 숫자 및
-, 예:xmas-ornament). 작업 파일의name, 입력 폴더reels/public/<name>/및 출력 폴더reels/exports/<name>/입니다. 이 작업에서 사용하는 파일만reels/public/<name>/에 복사하고 원본은 그대로 두세요. 각 입력이 어디서 왔는지, 그리고public/의 복사본이 유일한 것인지(다운로드 또는 생성된 파일) 보고서에 기록하세요. 각src를<name>/<file>로 작성하세요. 각 파일의 길이는ffprobe로 확인하세요. 미디어는 절대 커밋되지 않습니다:public/은 git에서 무시되므로 예제 작업의 경로(footage.mp4,music.m4a,demo/…)는 직접 파일을 넣을 때까지의 자리 표시자입니다. - 텍스트를 배치하기 전에 푸티지를 살펴보세요: 각 샷의 프레임을 추출하고(
ffmpeg -ss <t> -i <file> -frames:v 1) 제품이 어디에 있는지 기록하세요. reels/jobs/examples/<Template>.json을 읽으세요. 해당 템플릿이 사용하는 모든 속성이 나열되어 있습니다.reels/jobs/<job>.json으로 복사하고 편집하세요. git에서 제외해야 하는 작업은reels/jobs/_local/을 사용하세요.
작업 파일:
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<lang>은 props 위에 병합되므로 번역된 문자열만 보관합니다. 객체 배열은 항목별로 병합됩니다(null은 기본 항목을 유지함); 문자열 배열은 대체됩니다.
모든 템플릿이 공유하는 속성:
hook:{ lines (1-3), band, size, duration }. 0초부터 표시, 기본 2.2초.cta:{ lines, button, band, size, duration }. 마지막duration초 동안 표시, 기본 2.5. 다른 캡션은 CTA가 시작되면 종료됩니다.music:{ src, volume }. 끝에서 페이드 아웃됩니다. 음성 아래에서는 약 0.15를 사용하세요.brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }.outline(기본값) 및box는 시끄러운 광고 스타일입니다.caption은 기본 앱 내 캡션 모양입니다: 하나의 어두운 둥근 상자에 흰색 문장 대소문자 텍스트, 밴드 상단에 페이드 인; 1인칭 스토리 라인으로 작성하고, 최대 30자의 2줄로 작성하세요.- 클립:
{ src, start (소스 시작부터 초), duration (화면에 표시되는 초), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }.transition은 해당 클립이 도착하는 방식입니다.
클립은 또한 시뮬레이션된 카메라를 사용합니다: zoom (1-2.5, focus 지점을 유지하는 확대), tilt (도, -15 ~ 15, 더치 앵글) 및 push (0-0.6, 클립이 도착할 때 짧은 흐림과 함께 카메라가 돌진한 다음 안정됨).
작업에서 생략된 속성은 꺼집니다: hook이 없는 작업은 예제가 무엇을 보여주든 훅이 없습니다.
src는 public/ 내의 경로 또는 https URL입니다. .jpg/.png/.webp는 재생 대신 느린 확대를 얻습니다.
3. 규칙
- 안전 영역. 모든 텍스트는 x 140-940, y 288-1248 안에 유지됩니다. 템플릿은 세 개의 밴드(
top(y 288-600),middle(600-930),lower(930-1248))를 통해 이를 강제합니다. 밴드만 선택하면 됩니다. - 브리프가 원하지 않는 한 제품에서 텍스트를 멀리 두세요. 추출한 프레임에서 각 밴드를 선택하세요. 모든 밴드가 샷의 제품을 가리는 경우 텍스트의
duration을 줄이거나 샷을 변경하세요. - 짧은 줄. 텍스트는 800px에 맞게 줄어들므로 긴 줄은 작아집니다. 줄당 라틴 문자 22자 또는 일본어 문자 12자를 목표로 하세요. 하나의 단어를
*별표*로 감싸서 강조 색상으로 칠하세요. - 클립 길이.
start + duration * speed는 소스의 끝을 넘지 않아야 합니다. 비디오의 길이는 클립 지속 시간의 합계입니다(BeforeAfter는duration을 사용함;Testimonial은 리뷰 더하기 CTA입니다). - 음악이 있을 때 비트에 맞춰 자르세요: 클립 지속 시간이 비트 위치에 합산되도록 만드세요.
- 글꼴. 라틴어, 베트남어(montserrat 또는 anton 및 모든 인터페이스 카드) 및 일본어가 작동합니다. 한국어, 태국어, 아랍어 등은 먼저
reels/src/lib/kit.tsx에 글꼴을 추가해야 합니다.
정적 클립이 적고 다양한 각도. 푸티지가 하나 또는 두 개의 고정 샷이고 브리프가 빠른 멀티 앵글 편집(쇼룸 투어 또는 트렌드 댄스 컷)인 경우 BeatCutAd를 사용하고 각 소스를 여러 번 재사용하되 focus, zoom, tilt 및 push를 다르게 설정하세요: 와이드 샷(zoom 약 1.02)으로 시작한 다음 비트당 하나의 디테일(텍스트, 캐릭터, 이름, 손, 가장자리)을 보여주고, tilt의 부호를 번갈아 사용하고, 768px 소스에서는 zoom을 1.7 이하로 유지하고, 와이드로 끝내세요. cut 전환을 사용하세요; push가 전환입니다. 이렇게 하면 푸티지의 프레임이 재구성되지만 실제로 새로운 카메라 각도를 만들 수는 없습니다.
템플릿 참고 사항:
ChatStory,NotesList,NotificationStack: 인터페이스가 먼저 재생된 다음clips(보상)이 번쩍이고 CTA가 그 위에 표시됩니다. 길이는 인터페이스 부분 더하기 클립입니다.hook은 생략하세요: 카드가 안전 영역을 채웁니다.background는 카드 뒤의 어두워진 미디어입니다.ChatStory: 메시지는 읽는 시간에 따라 속도가 조절됩니다. 비트를 강제하려는 경우에만at(초)을 설정하세요. 메시지는text대신 또는text와 함께image(제품 사진)를 포함할 수 있습니다.NotesList:check: true는 입력된 후 줄에 체크 표시를 하고,highlight: true는 표시합니다. 제품 줄은 마지막에 두세요.SearchHook:pick은 선택되는 제안입니다. 질문을 34자 미만으로 유지하세요.NotificationStack:icon은 이모지 하나이고,color는 타일 색상입니다. 언어별로now와date를 번역하세요.PolaroidDump: 정사각형에 가까운 사진이 가장 잘 작동합니다.title은 손글씨입니다. 캡션은 20자 미만으로 유지하세요. 클립이 없습니다: 사진이 비디오입니다.Ranking:items는 작성된 순서대로 재생되므로 가장 낮은 순위를 먼저 쓰고 순위 1을 마지막에 쓰세요. 레이블은 20자 미만으로 유지하세요.PollSticker:percent값은 설정할 수 있습니다. 브리프에 실제 숫자가 있으면 실제 숫자를 사용하고, 발명된 숫자를 설문 조사 데이터로 제시하지 마세요.- 이러한 인터페이스에서 사람들이 문자를 보내고 게시하는 방식으로 카피를 작성하세요: 소문자도 괜찮고, 짧은 줄, 사람이 사용할 이모지. 이름, 메시지 및 리뷰는 브리프가 실제 것을 제공하지 않는 한 예시용이므로, 실제 사람에게 귀속시키지 마세요.
UgcCaptions:words는{ text, start, end }이며 출력 타임라인의 초 단위입니다. 단어 타임스탬프가 있는 대본에서 가져오세요. 타이밍을 추측하지 마세요.keepAudio는 기본적으로 true입니다. "단어"는wordsPerPage: 1과 함께 짧은 구문일 수 있습니다.CommentReply및OfferPromo:hook은 생략하세요. 버블이나 헤드라인이 이미 상단 밴드를 사용합니다.OfferPromo: CTA는 기본적으로 하단 밴드입니다.Testimonial: CTA 밴드를middle로 설정하세요.ProductSlideshow:badge는 두 줄에\n을 사용합니다.badgeBand로 배치하세요.
4. 확인 후 렌더링
reels/에서 다음을 실행하세요.
node render.mjs jobs/<job>.json --still=1,6,12 --guides # 안전 영역 밴드가 상단에 그려짐
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json # 모든 언어 -> exports/<name>/
스틸은 out/stills/에 절반 크기로 저장됩니다. 열어서 확인하세요: 텍스트가 제품에서 벗어나 있고, 잘린 것이 없으며, 각 언어가 맞습니다. 훅, 중간 캡션 및 CTA 내에서 스틸 시간을 선택하세요. _GUIDES로 명명된 파일은 확인용일 뿐입니다. 결과물로 절대 제공하지 마세요.
스틸이 통과한 후에만 비디오를 렌더링하세요. 스틸이 실패하면 작업을 수정하고 다시 확인하세요. 세 번 실패한 후에는 차단 요소로 보고하세요. 렌더링은 파일당 한 줄씩 경로와 길이를 출력합니다. 브리프에 명시되지 않는 한 비디오를 게시하거나 업로드하지 마세요.
모든 작업은 요청자에게 보고서로 끝납니다. 보고서에는 다음이 포함됩니다:
- 출력 경로 및 길이;
- 브리프가 명시하지 않은 경우 사용된 기본값 및 템플릿;
- 각 입력의 출처 및
public/에 유일한 복사본이 있는지 여부; - 섹션 6의 정리가 제거한 내용 및 확보된 공간.
5. Instagram 크기
렌더링은 약 16Mbps입니다. 업로드를 위해 압축하려면:
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. 미디어 및 디스크 공간
미디어가 디스크를 채웁니다. 입력(푸티지, 사진, public/<name>/에 복사된 음악) 및 출력( exports/<name>/의 비디오, 15초 기준 언어당 약 30MB)은 모두 동일한 이름의 작업에 속합니다. 정리가 작업별로 작동하므로 그렇게 유지하세요. 다른 모든 것은 스크래치입니다: out/의 QA 스틸 및 Remotion이 OS 임시 폴더에 쓰는 임시 번들(각각 public/의 전체 복사본을 보유함, render.mjs는 자체 번들을 삭제하지만 충돌 실행 및 Studio는 일부를 남김). node_modules/.cache의 webpack 캐시는 수백 MB까지 커집니다. node_modules/(헤드리스 브라우저 포함 약 1.3GB)는 일회성 비용입니다. 작업을 다시 렌더링하면 동일한 이름의 파일이 덮어쓰여지므로 한 작업을 반복해서 렌더링해도 쌓이지 않습니다.
reels/clean.mjs가 없으면(이전 키트에서 작업 공간을 만든 경우) 이 스킬의 assets/reels-kit/에서 clean.mjs 및 render.mjs를 reels/로 먼저 복사하세요.
reels/에서 렌더링이 실행되는 동안에는 절대 실행하지 말고 다음을 실행하세요:
node clean.mjs --auto --keep=<number of recent jobs to keep>
이 명령은 out/의 모든 스틸, OS 임시 폴더의 남은 번들, public/<name>/ 및 exports/<name>/를 자르고 최근 <number>개의 작업만 유지합니다. node_modules/는 건드리지 않습니다. <number>가 없으면 기본값은 0입니다(모든 작업 정리).
clean.mjs는 작업 파일을 만지지 않습니다. 작업을 다시 렌더링하려면 먼저 미디어를 다시 다운로드하거나 복사해야 할 수 있습니다.
7. 새 템플릿 추가
섹션 1의 어떤 템플릿도 브리프에 맞지 않으면 새 템플릿을 추가할 수 있습니다.
- 추가하기 전에 기존 템플릿을 수용 가능한 방식으로 조정할 수 있는지 확인하세요. 예를 들어,
BeatCutAd의 무음 부분은 짧은 제품 비디오에서 대부분의 광고 요구를 처리합니다. - 더 긴 단계가 필요한 경우 요청자에게 문의하세요. 브리프에 스토리보드 또는 참조가 포함되어 있지 않으면 중단하고 보고하세요.
- 다음 구조로
reels/src/<Template>.tsx에 새 템플릿을 작성하세요. 기존 템플릿(예:reels/src/BeatCutAd.tsx)을 복사하여 시작하세요. reels/src/Register.ts에서 템플릿을 등록하세요.- 템플릿이 작동하는지 확인하기 위해
render.mjs jobs/examples/<Template>.json --still=0을 실행하세요. - 제대로 작동하면 예제 작업을
reels/jobs/examples/아래의<Template>.json에 저장하세요.
새 템플릿에는 다음이 필요합니다:
- React 컴포넌트(
reels/src/<Template>.tsx) reels/src/Register.ts의 등록reels/jobs/examples/<Template>.json의 예제 작업
이러한 각 파일을 작업 폴더에 작성하세요. 스킬 폴더 내의 파일은 편집하지 마세요.