Remotion Shorts 스킬
쇼츠는 장면들의 JSON 파일로 작성합니다. 번들된 Remotion 프로젝트가 단어를 배치하고, 각 장면을 읽기 속도에 맞게 시간을 조절하며, 텍스트를 앱 버튼이 덮지 않는 영역 안에 유지하고, 리뷰 시트, 커버 및 MP4를 렌더링하며, 사용자는 WoopSocial로 게시할 수 있습니다.
각 비디오에 대해 Remotion 코드를 작성하지 않습니다. 템플릿은 고정되어 있고 테스트되었습니다. 여러분의 작업은 각 화면에 무엇을, 어떤 순서로, 얼마나 빠르게 표시할지에 대한 스크립트입니다.
0. 설정 (각 머신당 한 번)
Node 20 이상이 필요합니다. node -v로 확인하고, 없으면 사용자를 https://nodejs.org 로 안내하세요. Remotion은 macOS 15 이상, Windows x64, 그리고 glibc 2.35+ (Ubuntu 22.04, Debian 12 이상)가 있는 Linux를 지원합니다.
node <skill-dir>/scripts/setup.mjs remotion-shorts
이 명령은 프로젝트를 ./remotion-shorts로 복사하고, 고정된 패키지(약 260MB)를 설치하며, Remotion이 렌더링에 사용하는 헤드리스 브라우저(100150MB)를 다운로드합니다. 처음 실행 시 13분이 소요됩니다. 스킬이 업데이트된 후 다시 실행하면 템플릿 파일을 새로 고치고(사용자가 변경한 파일은 .bak으로 보관됨), 사용자의 스크립트, 에셋 또는 출력물은 건드리지 않습니다.
라이선스. Remotion은 개인 및 최대 3명의 회사에 무료입니다. 4명 이상의 회사는 Remotion 회사 라이선스가 필요하며, 스크립트에서 렌더링하는 것은 자동화로 간주됩니다 (remotion.pro/license). 더 큰 회사를 위해 렌더링하는 경우, 첫 렌더링 전에 한 번 분명하게 알려주세요.
1. 필요한 것 묻기 (한 메시지로, 이미 알고 있는 것은 생략)
- 자료. 주제, 기사, URL, 노트, 데이터, 변경 로그 또는 목록. 확인할 수 있는 사실만 작성합니다. 사용자가 출처 없이 주제만 제공하면, 기본 출처(공식 통계, 문서, 제품 자체 변경 로그)를 찾아 이름을 밝힙니다.
- 대상과 핵심 메시지 하나. 하나의 쇼츠는 한 가지를 말합니다.
- Look. 테마(
ink,paper,volt,ocean,clean) 또는 브랜드 색상, 그리고 종료 화면용 핸들. - 오디오. 기본 제공되는 사운드 효과는 기본적으로 켜져 있습니다(훅에서 히트, 각 컷마다 우쉬, 강조 표시에서 팝, 카운트업에서 틱). 이 템플릿을 위해 제작되었으며 모든 앱에서 안전합니다. 음악은 사용자가 사용할 권리가 있는 파일에서만 가져옵니다(무료 라이브러리가 세 앱 모두에서 안전하지 않은 이유는
references/writing-shorts.md참조). - 게시 위치. TikTok, Reels, Shorts 또는 모두.
2. 스크립트 작성하기
세션의 첫 번째 스크립트를 작성하기 전에 references/writing-shorts.md를 읽으세요. 요약 버전:
- 장면 1은 훅입니다. 약 10단어 이하로 보상을 명시합니다: 숫자, 주장 또는 목록 약속("5가지 무료 도구로 대체..."). 프레임 0부터 화면에 완전히 표시됩니다. 훅에 숫자가 있으면
big에 넣어 눈에 가장 먼저 띄도록 합니다. - 장면당 하나의 아이디어. 장면은 문단이 아니라 비트입니다. 통계 장면은 하나의 숫자와 그 의미를 전달합니다. 목록 항목은 내림차순 또는 오름차순으로 세며, 훅에서 이를 명시합니다.
- 모든 장면에 실제 정보가 있어야 함. 새로운 내용이 없는 템플릿 텍스트 비디오는 YouTube에서 진위성 없는 콘텐츠, Instagram에서 독창적이지 않은 콘텐츠로 간주됩니다. 절대 늘리지 마세요.
- 숫자는 정확하고 출처가 명확해야 함. 출처를
footer("데이터: USGS")에 넣습니다. 숫자를 다른 주장으로 반올림하지 마세요. - 하나의 행동으로 끝내거나 훅으로 다시 연결되어 루프가 연속적으로 느껴지도록 하는 라인으로 끝냅니다. "시청해 주셔서 감사합니다" 없음.
- 길이: 15~45초가 목표이며, 59초를 초과하면 렌더러가 경고합니다.
프로젝트 폴더에 short.json을 작성합니다. 전체 형식, 모든 장면 유형 및 모든 옵션은 references/short-json.md에 있습니다. 최소 스크립트 예시:
{
"theme": "ink",
"footer": "데이터: USGS",
"handle": "@yourhandle",
"scenes": [
{ "type": "hook", "big": "2.5%", "text": "지구 물의 담수 비율" },
{ "type": "stat", "value": "96.5", "suffix": "%", "label": "는 바다의 염수" },
{ "type": "stat", "value": "68.7", "suffix": "%", "label": "의 담수는 얼음과 빙하", "highlight": "얼음과 빙하" },
{ "type": "end", "text": "퀴즈 밤을 위해 저장하세요", "highlight": "저장하세요" }
]
}
3. 비디오 렌더링 전 확인하기
cd remotion-shorts
node render.mjs short.json --stills
몇 초 안에 계획(각 장면의 시간 및 글꼴 크기)을 출력하고 다음 파일을 작성합니다:
out/short/sheet.jpg: 모든 장면의 마지막 프레임(화면에 표시되는 모든 것), 안전 영역이 얇은 점선으로 표시됨(텍스트는 그 안에 있어야 함).out/short/cuts.jpg: 프레임 0과 각 컷 주변 프레임으로 모션을 확인합니다.out/short/cover.jpg: 훅이 완전히 표시된 후의 모습(Reels 커버로 업로드).out/short/report.json: 타이밍, 줄 바꿈 및 경고.
두 시트를 열고 살펴보세요. 확인: 모든 장면이 휴대폰 크기에서 읽을 수 있는지, 각 장면이 한 가지를 말하는지, 강조 표시가 중요한 단어에 있는지, 좁아 보이는 부분은 없는지, 순서가 올바른지, 프레임 0에 전체 훅이 표시되는지. JSON을 수정하고 게시할 때까지 --stills를 다시 실행하세요.
경고는 비디오 렌더링을 중단합니다(종료 코드 2): 한 화면에 너무 긴 텍스트, 너무 긴 훅, 텍스트에 없는 강조 표시, 읽기에 너무 빠른 장면, 0.85~1.25 범위를 벗어난 속도, 또는 59초를 초과하는 쇼츠. 스크립트를 수정하세요. 사용자가 경고를 확인하고 그래도 원할 때만 --force를 사용하세요. 일부 문제는 --force로 재정의할 수 없는 오류입니다. 예를 들어 어떤 크기에서든 화면 너비를 초과하는 단어는 텍스트가 화면 밖으로 나가게 합니다.
4. 렌더링
node render.mjs short.json
out/short/short.mp4를 작성합니다: 1080x1920, 30fps, H.264, yuv420p, AAC(음악이 없으면 무음 트랙), TikTok, Reels 및 Shorts에서 모두 허용됩니다. 30초 쇼츠는 최신 노트북에서 약 1분 만에 렌더링됩니다. 8GB 메모리 기계는 한 번에 2프레임을 렌더링합니다. 렌더링이 여전히 메모리 부족으로 중단되면 --concurrency 1로 다시 실행하세요.
보여주기 전에 세 프레임(시작, 중간, 끝)을 가져와 보거나, 클라이언트가 가능하면 재생해 보세요. 그런 다음 사용자에게 커버, 시트 및 MP4 경로를 보여줍니다.
여러 계정: 동일한 파일을 여러 계정에 게시하지 마세요. 계정당 하나의 변형(다른 훅, 테마 또는 장면 순서, 자체 JSON으로 저장)을 만들어 두 계정이 거의 중복된 것을 게시하지 않도록 합니다.
5. 게시 (WoopSocial, 확인 포함)
references/woopsocial.md를 읽으세요. 간단히 설명:
social_accounts_list로 계정을 찾습니다(필요하면 먼저 연결).- TikTok의 경우
social_accounts_get_platform_inputs로 계정의 개인정보 옵션과 허용되는 가장 긴 비디오를 확인합니다. 사용자가 개인정보를 선택하며 기본값은 없습니다. - 업로드:
media_uploads_create_session을report.json의 정확한 바이트 크기로 호출하고, 응답을session.json으로 저장한 후node upload.mjs session.json out/short/short.mp4를 실행하고,READY상태가 될 때까지media_uploads_complete_session을 호출합니다. - 플랫폼별 캡션을 작성합니다(TikTok 및 Reels: 비디오에 추가하는 한 줄과 3~5개의 특정 해시태그; YouTube: 100자 미만의 제목과 설명). 플랫폼별 텍스트에는
contentOverride를 사용합니다. posts_validate를 실행한 후 사용자에게 계정, 플랫폼별 캡션, 개인정보, 시간대가 포함된 예약 시간, 커버를 보여줍니다. 명확한 승인을 기다립니다. 그런 다음posts_create및posts_get을 실행합니다.
공개 필드: 쇼츠가 사용자 자신의 제품을 홍보하는 경우 TikTok에서 isYourBrand: true; 사실적인 AI 이미지, 비디오 또는 음성에 대해서만 isAiGeneratedContent(동적 텍스트는 필요 없음). YouTube madeForKids는 법적 선언입니다: 물어보고 추측하지 마세요.
6. 보고
다음을 보여줍니다: MP4 경로, 길이, 시트, 게시된 위치(posts_get의 링크) 또는 일정, 그리고 할 수 없었던 것. 조회수나 결과를 절대 만들어내지 마세요. 나중에 social_account_posts_list로 읽고 수집된 날짜를 보고합니다.
모양 편집하기
- 브랜드 색상:
theme을 객체(bg,fg,accent,accentText,font,uppercase)로 전달합니다. 텍스트 대비를 7:1 이상으로 유지하고 배경에 대한 강조 색상도 확인하세요. - 장면 뒤의 사진 또는 비디오: 장면당
image또는 쇼츠 전체에background. 텍스트를 읽기 쉽게 유지하기 위해 테마 색상 아래에서 흐리게 표시됩니다. 사용자가 소유하거나 라이선스가 있는 파일을 사용하고, 라이선스가 요구하는 경우 캡션에 출처를 표시하세요. - 번들 폰트: Anton(응축, 대문자, 강렬함), Poppins, Inter. 모두 OFL.
- 템플릿 자체를 변경하려면
src/Short.tsx를 편집하고npm run studio로 미리보기하세요.
엣지 케이스
- 숫자에 대한 출처 없음: 사용하지 마세요. 무엇이 누락되었는지 말하세요.
- 맞지 않는 텍스트: 장면을 분할하세요. 최소 글꼴 크기 이하로 줄이지 마세요(렌더러가 허용하지 않음).
- 오른쪽에서 왼쪽 또는 CJK 텍스트, 또는 이모지: 번들 폰트가 이를 지원하지 않으며 빈 상자로 표시될 수 있습니다. 그렇게 말하고 포함하지 마세요(이모지는 캡션에 넣을 수 있음).
- 사용자가 트렌드 사운드를 원하는 경우: API 게시물에는 추가할 수 없습니다.
postMode: MEDIA_UPLOAD로 TikTok에 게시하여 앱에서 마무리할 수 있도록 사용자의 TikTok 받은편지함에 도착하게 하세요. - Linux에서 누락된 라이브러리로 렌더링 실패:
references/platform-specs.md에 나열된 패키지를 설치하세요. - Windows: 항상 JSON 파일로 props를 전달하고, 명령줄에 인라인으로 전달하지 마세요.
품질 기준
완료되었다고 판단하기 전에 다음 모든 기준을 통과해야 합니다:
- 프레임 0에 전체 훅이 표시됨(cuts.jpg 확인). 약 10단어 이하로 보상을 명시.
- 모든 장면이 한 가지를 말함. 장면당 약 14단어 이하.
- 모든 숫자가 출처와 일치하며, 출처가 화면이나 캡션에 표시됨.
- 경고가 없거나 사용자가 경고를 확인하고
--force를 선택함. - 두 시트 모두 확인: 점선 안전선 밖으로 텍스트가 나가지 않고, 올바른 단어에 강조 표시됨.
- 15~59초.
- 각 계정에 대해 고유한 버전.
- 게시 전에 사용자가 확인함.