Communitygithub.com

srt2reel

내레이션 오디오 파일과 SRT 자막에서 애니메이션 스토리 비디오를 만듭니다. 릴스, 쇼츠, 틱톡용 세로 1080x1920 숏폼이나 유튜브용 가로 1920x1080 영상을 최대 15분까지 제작합니다.

srt2reel란 무엇인가요?

srt2reel은 사용자가 제공한 음성 파일(MP3, WAV, M4A)과 정확한 대본이 담긴 SRT 파일을 입력받아 30fps의 애니메이션 스토리 비디오를 제작하는 AI 에이전트 스킬입니다. 모든 언어와 문자 체계를 지원하며, 플랫 벡터 캐릭터와 배경을 그리고 SRT 원문을 타임드 캡션으로 표시하고 주요 단어를 강조합니다. 각 장면에 태그와 배경 효과음을 추가하며, 최종 출력물을 검증합니다. 클로드 코드, 코드스, 커서 등 다양한 AI 코딩 에이전트 플랫폼에서 사용 가능하며, 사용자가 직접 음성과 자막 파일을 제공해야 합니다. 이 스킬은 비디오 제작만 담당하며, 이야기나 대본을 작성하지 않고 음성을 생성하지도 않습니다. 세로형(1080x1920, 숏폼)과 가로형(1920x1080, 장편)을 지원하며, 사용자 요청에 따라 형식을 선택합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/speedsharmaai/srt2reel/tree/main/skills/srt2reel

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

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

문서

srt2reel은(는) 무엇을 하나요?

음성 파일과 SRT를 30fps 스토리 비디오로 변환합니다: 간단한 벡터 캐릭터가 있는 애니메이션 장면, SRT 원문을 보여주는 캡션 카드, 각 장면의 이름 태그, 부드러운 효과음이 포함됩니다. 두 가지 형식을 지원합니다: portrait (1080x1920, 숏폼) 및 landscape (1920x1080, 긴 영상).

이 스킬은 비디오를 제작합니다. 절대 이야기를 작성하지 않습니다. 사용자가 주제나 아이디어만 제공하는 경우, 이 스킬은 음성 파일과 SRT가 필요하다고 말하고 두 가지를 모두 요청하세요.

사용자가 사용하는 언어로 짧고 평이한 문장으로 대화하세요. 사용자는 기술에 능숙하지 않을 수 있습니다.

파일 위치

스킬 폴더는 ${CLAUDE_SKILL_DIR}입니다. 이 경로가 문자 그대로의 자리 표시자로 표시되면, 이 SKILL.md가 있는 폴더를 의미합니다. 아래에서는 SKILL이라고 부릅니다.

  • SKILL/scripts/에는 다섯 개의 명령이 있습니다. 그대로 실행하고, 다시 작성하지 마세요.
  • SKILL/template/는 init.ts가 복사하는 비디오 프로젝트입니다.
  • SKILL/references/는 단계에서 참조를 가리킬 때 읽을 세부 정보가 있습니다.
  • SKILL/assets/kit.jpg는 모든 기성 장면 조각을 보여줍니다(가로형은 kit-wide.jpg).

각 비디오는 자체 프로젝트 폴더를 가지며, 아래에서는 PROJECT라고 부릅니다. ~/reels/<짧은-이름>을 사용하세요.

입력

  1. 음성 파일 (MP3, WAV 또는 M4A).
  2. 정확한 구어 내용이 담긴 SRT 파일. 파일이 없으면 요청하세요. 직접 오디오를 전사하지 마세요: 음성-텍스트 변환은 단어를 틀릴 수 있으며, SRT가 진실 공급원(source of truth)입니다.
  3. 선택 사항: 페이지나 채널 이름 (작은 워터마크로 표시), 색상 테마 (paper, mint, sky), 캐릭터나 장면 아이디어, 사용자가 직접 사용할 사진.

사용자가 요청하는 내용에 따라 형식을 선택하세요. 릴스, 쇼츠 또는 틱톡용 숏폼은 portrait입니다. 유튜브 채널, 강의, 또는 3분이 넘는 영상은 landscape입니다. 명확하지 않으면 물어보세요.

단계

다음 순서로 진행하세요. 각 명령은 수행한 작업과 다음에 할 일을 출력합니다.

1. 시스템 확인

node SKILL/scripts/doctor.ts

FAIL이 출력되면, 무엇이 누락되었는지 사용자에게 명확히 알리고 중단하세요. ffmpeg나 Node가 없으면 해결 방법을 시도하지 마세요. warn 줄은 괜찮습니다.

2. 프로젝트 생성

node SKILL/scripts/init.ts PROJECT --voice <음성 파일> --srt <srt 파일> [--format landscape] [--lang <태그>] [--page "<이름>"] [--theme <이름>]

이 명령은 템플릿을 복사하고, 설치하며, 음성을 측정하고, 실제 일시 정지를 찾아, 각 SRT 큐당 하나의 캡션을 음성에 맞게 이미 시간이 조정되고 화면에 맞게 줄바꿈된 PROJECT/src/story.json을 작성합니다. 또한 언어에 맞는 글꼴을 설치합니다.

전체 출력을 읽으세요. 각 캡션의 시간과 장면을 전환할 수 있을 만큼 긴 모든 일시 정지를 나열합니다. SRT와 음성의 길이가 일치하지 않는다고 경고하면, 계속 진행하기 전에 사용자에게 물어보세요.

언어는 SRT의 문자 체계에서 추측됩니다. 추측이 틀릴 수 있는 경우 --lang을 전달하세요: 영어 이외의 라틴 문자 언어 (es, fr, id, vi), 중국어 번체 (zh-TW), 우르두어 또는 페르시아어 (ur, fa), 마라티어 또는 네팔어 (mr, ne). references/languages.md를 참조하세요.

3. 장면 계획

캡션을 하나의 이야기로 읽고 장면으로 분할하세요. 장소, 시간, 화자 또는 아이디어가 바뀔 때, 약 47초마다 새 장면을 시작하세요. 25초 이야기에는 57개의 장면이 있고, 60초 이야기에는 9~14개가 있습니다. 캡션당 하나의 장면은 너무 많습니다. 각 컷을 나열된 일시 정지 중 하나에 배치하고, 문장 중간에 넣지 마세요.

각 장면에 대해 다음을 결정하세요: 장소, 등장인물, 그들이 하는 일, 그리고 캡션이 말하는 내용을 보여주는 시각적 요소 하나(소품, 숫자, 계기판, 도장)로, 단순히 사람이 말하는 것만이 아니어야 합니다. 이야기의 저점에는 어두운 장면을 사용하세요. 이야기의 마지막 교훈이나 결과로 끝내세요.

약 2분보다 긴 비디오는 장면을 하나하나 작성하기에는 너무 많습니다. 이러한 경우 references/long-videos.md를 따르세요.

4. 두 개의 스토리 파일 작성

비디오마다 변경되는 파일은 이 두 개뿐입니다. src/lib/ 아래의 모든 것은 그대로 두세요.

  • PROJECT/src/story.json: 시간과 태그가 있는 장면 목록, 캡션의 키워드, 누가 언제 말하는지, 효과음. 형식 및 규칙: references/story.md.
  • PROJECT/src/scenes.tsx: 장면당 하나의 작은 컴포넌트와 이를 이름 짓는 SCENES 객체. 장면 그리는 방법, 전체 키트, 레이아웃 영역: references/scenes.md. 먼저 SKILL/assets/kit.jpg를 보고, 그런 다음 PROJECT/src/lib/examples.tsx(가로형은 examples-wide.tsx)를 복사하세요.

캡션 문구는 고정입니다. 키워드 주위에 {중괄호}를 추가하고, 줄 바꿈을 변경하고, 두 개의 캡션을 병합하거나 하나를 분할하고, 시간을 이동할 수 있습니다. 단어를 추가, 삭제 또는 변경할 수 없습니다. 5단계 검사에서 차이를 발견하면 거부합니다.

직접 추가하는 화면 텍스트(태그, 레이블, 말풍선)는 SRT의 언어여야 합니다. 내레이션이 이미 말하는 내용을 명명하는 한두 단어(장소, 상점 간판, 반응)로 제한하세요. 새로운 사실이나 문장을 추가하지 마세요.

5. 검사하고, 깨끗해질 때까지 반복

node SKILL/scripts/check.ts PROJECT

캡션 문구를 SRT와 비교하고, 시간, 장면, 강조 및 글꼴을 확인하고, 장면 코드를 컴파일합니다. 모든 ERROR를 수정하고 다시 실행하세요. 각 warn을 읽고 실제 문제인 것을 수정하세요.

6. 프레임 확인하고, 올바를 때까지 반복

node SKILL/scripts/stills.ts PROJECT

이 명령은 각 컷 직후와 각 캡션 중간에 하나씩 프레임을 렌더링하고, 이를 연락처 시트(contact sheets)로 타일링합니다. 나열된 모든 시트를 열어 살펴보세요. 각 셀에는 시간, 장면 및 캡션 번호가 표시됩니다.

다음 사항을 찾아 수정하세요:

  • 상단의 태그나 하단의 캡션 카드를 덮거나 닿는 모든 것
  • 카드를 넘치는 텍스트 또는 빈 상자로 그려진 문자
  • 캡션 내용을 보여주지 않는 장면
  • 장면 간에 외형이 바뀌는 캐릭터
  • 빈 장면 또는 거의 빈 장면

--grid를 추가하여 모든 프레임에 콘텐츠 상자와 눈금자를 그립니다. 영역을 침범하는 것이 무엇인지, 어디로 이동해야 하는지 확인하는 데 사용하세요. 수정 후 몇몇 순간을 다시 보려면: node SKILL/scripts/stills.ts PROJECT --at 12.5,30. 각 실행은 이전 실행의 시트를 대체합니다.

시트를 살펴보지 않고 전체 비디오를 렌더링하지 마세요.

7. 렌더링

렌더링은 빠른 머신에서 비디오 길이만큼, 작은 머신에서는 몇 배 더 오래 걸리므로 백그라운드에서 실행하고 폴링하세요:

node SKILL/scripts/render.ts PROJECT --detach
node SKILL/scripts/render.ts PROJECT --status

--status는 rendering, finishing, done 또는 failed를 출력합니다. 20~30초마다 확인하고, done 또는 failed에 도달하기 전에 턴을 종료하지 마세요. 확인 사이에 일시 중지할 수 없으면, 명령이 사용자를 기다리게 하세요: node SKILL/scripts/render.ts PROJECT --status --wait 100은 렌더링이 끝나거나 100초 후에 결과를 반환합니다. 완료될 때까지 다시 실행하세요.

사용자에게 전달하는 파일에 크기 제한이 있는 경우(claude.ai 채팅은 30MB 허용), --max-mb 28을 추가하세요.

렌더링은 음량을 균일하게 만든 후 완성된 파일을 확인합니다: 프레임 크기, 프레임 속도, 코덱, 길이. --status는 결과와 final_check.jpg의 경로(완성된 파일에서 나열된 시간에 찍은 네 개의 프레임)를 출력합니다. 해당 이미지를 살펴보세요.

8. 전달

사용자에게 PROJECT/out/final.mp4를 제공하세요. 완벽하지 않은 점을 한 줄과 제안하는 다음 단계를 한 줄 추가하세요. 모든 것이 괜찮다면, 한 줄로 그렇게 말하세요.

비디오에 포함될 내용 규칙

  • SRT가 말하는 내용만 표시하세요. 자신의 주장, 사실 또는 약속을 추가하지 마세요.
  • 정치, 증오, 실제 인물에 대한 모욕 금지. 사실로 제시되는 의학적 또는 재정적 조언 금지. 민감한 주제는 부드럽게 다루세요.
  • 다른 제작자의 캐릭터, 장면 또는 디자인을 복사하지 마세요. 이 이야기만의 것을 그리세요.
  • 사용자에게 조회수, 도달 범위 또는 수익을 약속하지 마세요.
  • 1초에 세 번 이상 깜빡이는 것이 없어야 합니다.

사용자가 알아야 할 사항

해당 사항이 관련될 때, 사용자의 언어로 한 번 말하세요:

  • 비디오는 Remotion으로 제작되며, 개인 및 3인 이하 회사에 무료입니다. 더 큰 회사는 Remotion 라이선스가 필요합니다: https://www.remotion.dev/docs/license
  • 플랫폼은 거의 동일한 템플릿 비디오를 많이 게시하는 채널에 대해 조치를 취하며, 복제되었거나 사실적인 합성 음성에 레이블을 요구할 수 있습니다. references/platforms.md를 참조하세요.

문제 발생 시

references/troubleshooting.md를 참조하세요. 머신이 전혀 비디오를 렌더링할 수 없는 경우(브라우저를 시작할 수 없음, ffmpeg 없음, 첫 설치를 위한 네트워크 없음), 명확히 말하고 다른 것을 생성하는 대신 중단하세요.

관련 스킬