Communitygithub.com

reels-templates

하나의 숏츠 영상이나 틱톡 광고를 푸티지, 사진 또는 브리프 하나로 제작합니다. 이 스킬에 포함된 15개의 기성 Remotion 템플릿을 사용합니다: 소셜 네이티브 형식(문자 메시지 스토리, 메모 앱 목록, 검색 바, 잠금 화면 알림, 폴라로이드 포토 덤프, 블라인드 랭킹, 투표 스티커) 및 광고 형식(비트컷 몽타주, UGC 워드 캡션, 리스트클, 이전/이후, 제품 슬라이드쇼, 사용후기, 댓글 답변, 판매 프로모션)을 제공합니다.

reels-templates란 무엇인가요?

이 스킬은 사용자가 짧은 수직 동영상(Reels, TikTok)을 제작하도록 돕는 AI 에이전트를 위한 강력한 도구입니다. 15개의 데이터 기반 Remotion 템플릿(1080x1920, 60fps)이 포함되어 있어, 간단한 JSON 작업 파일 하나로 전체 동영상 제작 과정을 자동화합니다. 사용자는 템플릿을 선택하고 필요한 속성(푸티지 경로, 텍스트, 음악 등)을 채우기만 하면 되며, 복잡한 React 코드를 작성할 필요가 없습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트가 완전히 자율적으로 실행할 수 있도록 설계되었습니다. 스킬은 작업 공간 설정, 템플릿 선택, 작업 파일 빌드, QA 스틸 확인, 최종 렌더링의 일련의 단계를 안내합니다. 또한 여러 언어(i18n)를 지원하며, 텍스트가 안전 영역 내에 배치되고 제품을 가리지 않도록 하는 규칙을 적용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

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

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

문서

Reels 템플릿

15개의 데이터 기반 Remotion 템플릿(1080x1920, 60fps)이 이 스킬의 assets/reels-kit/ 폴더에 포함되어 있습니다. 하나의 동영상은 하나의 JSON 작업 파일입니다. 템플릿을 선택하고, 속성을 채우고, 렌더링하세요. 일반 작업에서는 React를 작성할 필요가 없습니다.

아래 경로 중 reels/로 시작하는 경로는 이 스킬 폴더가 아닌 작업 폴더를 가리킵니다. 작업 중에는 스킬 폴더 내의 파일을 절대 편집하지 마세요.

무인 실행. 이 스킬은 자율 에이전트용으로 제작되었습니다. 요청자는 작업을 시작한 주체(오케스트레이션 에이전트, 파이프라인, 또는 사람)입니다. 이 파일의 규칙에 따라 모든 결정을 내리고, 단계 승인을 위해 절대 멈추지 마세요. 해결할 수 없는 차단 요소(도구 누락, 미디어 없음 또는 읽을 수 없음, 계속 실패하는 렌더링)가 있을 때만 멈추고 보고하세요. 모든 작업은 보고서(섹션 4)로 끝납니다.

0. 작업 공간 설정

프로젝트당 한 번, 첫 번째 작업 전에 수행하세요.

  1. 도구를 확인하세요: Node.js 18 이상(node -v), ffmpeg 및 ffprobe가 PATH에 있어야 합니다. 하나라도 없으면 멈추고 차단 요소로 보고하세요. 시스템 소프트웨어를 직접 설치하지 마세요.
  2. 작업 폴더에 이미 reels/render.mjs가 있으면 해당 작업 공간을 사용하고 섹션 1로 건너뛰세요.
  3. 그렇지 않으면 이 스킬의 assets/reels-kit/ 폴더를 작업 폴더의 reels/로 복사한 다음(예: cp -R <skill-dir>/assets/reels-kit reels), reels/ 안에서 npm install을 실행하세요.
  4. 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잠금 화면이 주문, 메시지, 리뷰로 가득 참: 사회적 증거 및 FOMO1~6개의 알림, 배경, 보상 클립
PolaroidDump손글씨 캡션이 있는 스크랩북 사진 덤프2~8장의 사진
Ranking블라인드 랭킹: 항목이 번호 목록에 떨어짐, #1이 마지막2~6개의 클립, 각각 레이블 및 순위
PollSticker푸티지 위의 스토리 투표: 두 가지 옵션, 탭, 결과질문, 백분율이 있는 2개의 옵션, 클립

광고 형식 (푸티지 우선, 텍스트 위에)

템플릿사용 시기필요 항목
BeatCutAd푸티지에서 잘라낸 제품 광고 기본값: 여러 샷, 훅, CTA1개 이상의 비디오 클립
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. 작업 빌드

  1. 작업 이름을 선택하세요(소문자, 숫자 및 -, 예: xmas-ornament). 작업 파일의 name, 입력 폴더 reels/public/<name>/ 및 출력 폴더 reels/exports/<name>/입니다. 이 작업에서 사용하는 파일만 reels/public/<name>/에 복사하고 원본은 그대로 두세요. 각 입력이 어디서 왔는지, 그리고 public/의 복사본이 유일한 것인지(다운로드 또는 생성된 파일) 보고서에 기록하세요. 각 src를 <name>/<file>로 작성하세요. 각 파일의 길이는 ffprobe로 확인하세요. 미디어는 절대 커밋되지 않습니다: public/은 git에서 무시되므로 예제 작업의 경로(footage.mp4, music.m4a, demo/…)는 직접 파일을 넣을 때까지의 자리 표시자입니다.
  2. 텍스트를 배치하기 전에 푸티지를 살펴보세요: 각 샷의 프레임을 추출하고(ffmpeg -ss <t> -i <file> -frames:v 1) 제품이 어디에 있는지 기록하세요.
  3. 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의 어떤 템플릿도 브리프에 맞지 않으면 새 템플릿을 추가할 수 있습니다.

  1. 추가하기 전에 기존 템플릿을 수용 가능한 방식으로 조정할 수 있는지 확인하세요. 예를 들어, BeatCutAd의 무음 부분은 짧은 제품 비디오에서 대부분의 광고 요구를 처리합니다.
  2. 더 긴 단계가 필요한 경우 요청자에게 문의하세요. 브리프에 스토리보드 또는 참조가 포함되어 있지 않으면 중단하고 보고하세요.
  3. 다음 구조로 reels/src/<Template>.tsx에 새 템플릿을 작성하세요. 기존 템플릿(예: reels/src/BeatCutAd.tsx)을 복사하여 시작하세요.
  4. reels/src/Register.ts에서 템플릿을 등록하세요.
  5. 템플릿이 작동하는지 확인하기 위해 render.mjs jobs/examples/<Template>.json --still=0을 실행하세요.
  6. 제대로 작동하면 예제 작업을 reels/jobs/examples/ 아래의 <Template>.json에 저장하세요.

새 템플릿에는 다음이 필요합니다:

  • React 컴포넌트(reels/src/<Template>.tsx)
  • reels/src/Register.ts의 등록
  • reels/jobs/examples/<Template>.json의 예제 작업

이러한 각 파일을 작업 폴더에 작성하세요. 스킬 폴더 내의 파일은 편집하지 마세요.

관련 스킬