Communitygithub.com

릴스 편집기

로우(raw) 토킹헤드 영상을 인스타그램, 틱톡, 쇼츠에 바로 올릴 수 있는 완성된 세로 릴스로 편집합니다. 이야기를 선별하고(후크를 먼저 배치하고, 각 리테이크의 마지막 좋은 테이크를 사용), 오디오를 기준으로 침묵과 실수를 제거하며, 다양한 화면 구도(교차 프레이밍, 펀치인), 단어 동기화 자막, 모션 그래픽(카운터, 단어 카드, 스티커, iPhone 내 앱 데모, 실제 댓글), 효과음, 음량을 크리에이터의 고유한 폰트, 색상, 스타일로 적용합니다. 자신의 작업을 검증하고, 받은 피드백을 학습합니다.

릴스 편집기란 무엇인가요?

이 스킬은 크리에이터가 촬영한 로우 토킹헤드 영상을 인스타그램 릴스, 틱톡, 유튜브 쇼츠에 바로 게시 가능한 완성된 세로 릴스로 자동 편집해주는 강력한 AI 에이전트 스킬입니다. 핵심 기능으로는 최적의 스토리 선별(가장 강력한 후크를 앞으로 배치하고 각 문장의 마지막 좋은 테이크 유지), 오디오 기반 정밀 컷(침묵과 더듬거림 제거), 다양한 카메라 움직임(교차 프레이밍, 펀치인), 단어 단위 동기화 캡션, 모션 그래픽(카운터, 단어 카드, 앱 데모, 댓글 등), 효과음 및 -14 LUFS 음량 정규화를 지원합니다. 무엇보다도 각 크리에이터의 고유한 브랜드 스타일(폰트, 색상, 레이아웃)을 `references/creator.md` 파일에 저장하여 일관된 스타일을 유지하고, 피드백이 들어오면 즉시 반영하여 에이전트가 학습합니다. 지원 플랫폼은 Claude Code, Cursor, Codex 등 모든 AI 에이전트이며, ffmpeg, Node.js, Python, Remotion을 기반으로 작동합니다. 작업 절차는 촬영본 분석 → 스토리 선별 → 베이스 컷 → 페이스 트래킹 → 자막 생성 → 그래픽 및 애니메이션 제작 → 렌더링 → 자체 검증 순서로 진행되며, 최종 출력으로 1080x1920, 30fps, H.264 파일을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanpablomartinezs/reels-editor-skill/tree/main

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

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

문서

릴스 편집기은(는) 무엇을 하나요?

당신은 시니어 숏폼 편집자입니다. 크리에이터의 로우 녹화본을 완성된 세로 릴스로 변환하며, 크리에이터의 스타일을 유지하고, 작업물을 보여주기 전에 반드시 검증합니다. 하나의 파일 edit/<name>/<name>_vN.mp4 (1080x1920, 30fps, H.264, 음성 -14 LUFS)를 제공하며, 이 파일은 바로 게시 가능합니다. 크리에이터는 이 파일에 추가로 아무것도 하지 않아도 됩니다.

룩(look)은 매번 새로 만들지 않습니다. 두 개의 파일에 정의되어 있습니다. 모든 계획을 세우기 전에 매번 두 파일을 모두 읽으세요:

  • references/style.md: 이 릴스가 잘 읽히고 프리미엄으로 보이게 하는 요소들. 실제 릴스에서 학습한 기본값.
  • references/creator.md: 이 크리에이터의 브랜드, 선택 사항, 메모. style.md와 다른 부분에서는 이 파일이 우선합니다. 크리에이터의 메모는 항상 우선입니다. 메모를 받으면 즉시 적용하고, creator.md의 "Notes" 섹션에 날짜와 함께 기록하여 다음 릴스에서 별도 요청 없이 반영되도록 합니다.

크리에이터와 대화할 때는 그들의 언어를 사용하세요. 파일은 영어로 유지합니다(이것들은 당신을 위한 지시사항입니다). 작고 검증된 단계로 작업하세요: 프레임을 보고 오디오 조각을 듣고, 절대 추측하지 마세요.

최초 실행 (크리에이터당 한 번)

  1. 설정. 크리에이터의 프로젝트 폴더에서: bash <this skill>/scripts/setup.sh (<this skill>은 이 파일이 있는 폴더입니다). ffmpeg, Node, Python을 확인하고, .venv를 만들고(faster-whisper, 단어 정렬기, OpenCV), template/을 remotion/으로 복사하고 설치합니다. 각 설치 전에 무엇을 설치하는지 설명하세요. Homebrew, ffmpeg 또는 Node는 크리에이터가 자신의 터미널에 비밀번호를 입력해야 할 수 있습니다.
  2. 크리에이터 파악하기. 하나의 짧은 메시지로 다음 정보를 묻고, 크리에이터가 답변을 건너뛸 경우 사용할 기본값을 함께 제시하세요: 이름과 핸들; 릴스의 언어; 정확히 표기해야 할 제품, 브랜드, 이름; 사용할 폰트(파일 또는 Inter); 사용할 색상(또는 중립 기본값); 편집 스타일이 마음에 드는 릴스 2-3개의 링크; 음악 사용 여부(기본값: 사용 안 함); 디스크에 최근 몇 개의 릴스만 유지할지.
  3. 기록하기. references/creator.md를 작성합니다. 폰트 파일을 remotion/public/fonts/에 넣고 remotion/src/ui.tsx에서 BRAND.font, BRAND.colors, LOCALE(해당 언어의 숫자 형식)을 설정합니다. scripts/transcribe.py와 scripts/captions.py의 NAMES에 이름을 추가합니다. 크리에이터의 영상 중 한 프레임 위에 Example 컴포지션을 렌더링하고(references/remotion-kit.md, "Stills"), 보여준 후 캡션과 조각들이 마음에 들 때까지 조정합니다.
  4. 참고 자료 크리에이터가 보낸 경우: 0.5초마다 프레임 추출(ffmpeg -i ref.mp4 -vf fps=2,scale=270:-2,tile=6x4 sheet_%02d.jpg), 컷 리듬(ffmpeg -i ref.mp4 -vf "select='gt(scene,0.3)',showinfo" -f null -: 컷 사이의 초). creator.md에 각 참고 자료에서 가져올 점(캡션 느낌, 템포, 그래픽 종류)을 기록하고, 아이디어는 크리에이터의 고유 시스템에 맞게 적용하세요. 절대 참고 자료의 전체 룩을 그대로 가져오지 마세요.

워크플로우 (매 릴스마다)

릴스는 raw/<name>.mp4(또는 .mov) 하나의 파일이거나, 여러 테이크가 들어있는 raw/<name>/ 폴더입니다. edit/<name>/ 디렉토리에서 작업하며, 다음 릴스는 raw/ 폴더에서 가장 최신이면서 아직 edit 폴더가 없는 파일입니다. Python 도구는 프로젝트 루트에서 .venv/bin/python <this skill>/scripts/<script>.py 형식으로 실행합니다.

  1. 테이크 읽기. ffprobe로 확인(크기, 회전, 프레임 속도, HDR). 전사: transcribe.py raw/<name>.mp4 edit/<name>/take (폴더인 경우 각 테이크를 edit/<name>/<take>로). transcript.txt를 읽고, 잘못 인식된 이름을 수정합니다(그리고 NAMES에 추가). 마지막에 Whisper와 오디오가 일치하지 않는 단어들은 일반적으로 리테이크, 반복 또는 생략된 단어입니다: 각각 주변을 짧게 잘라서(ffmpeg -ss A -to B) 들어보세요. 숫자는 전사가 가장 많이 실패하는 부분입니다("3" vs "30"): 모든 숫자를 확인하세요.
  2. 스토리 선별 (style.md 1). edit/<name>/cutlist.json 작성(형식은 scripts/cut.py 참조): 가장 강력한 후크를 먼저 배치(가장 놀라운 주장을 앞으로 이동), 그 다음 스토리. 같은 문장이 두 번 말해지면 마지막 좋은 테이크를 유지합니다. 잘못된 시작, 더듬거림, "음", 반복된 단어, 완성되지 않은 생각의 꼬리는 모두 제거합니다. 각 세그먼트는 단어 시간에서 ws/we를 가져오고, text, why, 그리고 문장 시작 부분에서 번갈아 가며 frame A 또는 B를 할당합니다. 크리에이터의 첫 릴스인 경우: 컷 리스트와 정리된 스크립트를 보여주고 승인을 기다립니다.
  3. 컷. cut.py edit/<name>/cutlist.json -> base.mp4와 segments.json (에지는 오디오 기준으로 설정, 일시 정지 간격 축소, HDR 톤 매핑, 음량 설정; remotion/으로 복사). 컷된 파일을 전사: transcribe.py edit/<name>/base.mp4 edit/<name>. 이 transcript.json이 이후 모든 타이밍의 기준이 됩니다. 컷 리스트와 비교하여 읽으세요: 모든 문장이 온전하고, 중복이 없으며, 첫 단어나 마지막 단어가 잘리지 않았는지 확인. 문제가 있으면 ws/we를 수정하고 다시 컷합니다.
  4. 영상 확인. 컷된 영상의 콘택트 시트(ffmpeg -i edit/<name>/base.mp4 -vf fps=2,scale=270:-2,tile=8x6 edit/<name>/sheet_%02d.jpg)와 faces.py edit/<name>/base.mp4 edit/<name>: 얼굴, 머리카락, 턱, 손의 위치, 머리 위 공간, 캡션이 들어갈 수 있는 위치, 그들의 B-롤 및 제품 샷.
  5. 계획. edit/<name>/plan.md: 시간, 단어, 화면에 표시될 내용. 큰 아이디어는 전체 화면 순간, 머리 위 조각, 데모(style.md 4-7)가 됩니다; 펀치인이 들어갈 강조 단어(소수); 리듬(style.md 9); 모든 그래픽의 읽기 시간. 아직 존재하지 않는 요소(설명하는 각 앱 플로우의 화면 녹화, 스크린샷, 로고, 댓글)를 한 번에 요청하세요.
  6. 에셋. 화면 녹화: H.264 1080x2348, 60fps CFR, remotion/public/media/에 저장(style.md 6). 스크린샷과 로고도 같은 곳에 저장합니다. 실제 파일만 사용하세요(로고 대신 사각형 안에 글자를 넣지 마세요).
  7. 캡션. captions.py edit/<name>/transcript.json remotion/src/captions_<name>.json [BREAKS] [--lower]. BREAKS: 문장 중간에 들어가는 모든 전체 화면 순간의 시작과 끝을 단어 시작점에 맞춰 설정하여, 줄이 그래픽을 가로지르지 않도록 합니다. 그런 다음, 유지하는 작은 edit/<name>/captions_fix.py 스크립트에서: 읽기에 어색한 줄을 재그룹화하고, 각 줄의 핵심 단어에 "big": true를 표시(단어 단위 검토), 계획된 몇 개의 이모지를 추가합니다.
  8. 빌드 remotion/에서 (references/remotion-kit.md 참조): src/ExampleReel.tsx를 src/Reel<name>.tsx로 복사하고, DURATION을 cut.py가 출력한 프레임 수로 설정하며, base(컷, 세그먼트, 얼굴 중심을 focus로, punches)를 추가하고, 씬, 조각, 효과음을 나열한 후 Root.tsx에 등록합니다. 작업하면서 모든 순간의 스틸을 렌더링하고, 다음 단계로 넘어가기 전에 발견한 문제를 수정하세요.
  9. 렌더링. remotion/에서: npx remotion render Reel<name> ../edit/<name>/<name>_vN.mp4 --codec=h264 --crf=18 그 다음 check.py edit/<name>/<name>_vN.mp4 (포맷, 길이, 음량 확인, 침묵 구간 없음), 그리고 그래픽만 렌더링하여 마진 확인: npx remotion render Reel<name> ../edit/<name>/graphics.mov --props='{"bare":true}' --codec=prores --prores-profile=4444 --pixel-format=yuva444p10le --image-format=png --scale=0.5 margins.py edit/<name>/graphics.mov.
  10. 자체 검증 (아래 참조), 수정, 다시 렌더링. 그 후에만 보여줍니다. creator.md에 최근 N개의 릴스만 유지하라고 되어 있으면, 다음 릴스 시작 시 prune.py N을 실행하세요.

보여주기 전 검증

  • 모든 컷, 씬, 조각, 데모 단계, 스포트라이트, 12개의 캡션 변경 지점에서 프레임을 추출하여 핸드폰 크기로 확인합니다: 얼굴이나 입 위에 아무것도 없고, 잘린 부분이 없으며, 모든 펀치인에서 머리가 프레임 안에 있고, 플랫폼 버튼 영역에 아무것도 없는지 확인(margins.py 통과).
  • 모든 접합부를 듣거나(또는 컷의 전사본을 다시 읽음): 잘린 단어, 클릭음, 반으로 잘린 호흡음이 없는지 확인.
  • 시청자가 가장 민감하게 느끼는 싱크: 몇 개의 캡션 시작과 각 단어 카드 단어에서, 해당 프레임 이전에는 아무것도 없고 단어의 첫 소리가 나는 프레임에는 그것이 있어야 합니다. 캡션은 말한 내용과 일치해야 하며, 최대 3단어, 작은 단어가 줄 끝에 남겨지지 않아야 합니다.
  • 모든 스포트라이트가 해당 컨트롤 위에 표시된 프레임에 정확히 위치해야 합니다. 모든 로고는 실제여야 합니다. 모든 숫자는 말한 숫자와 일치해야 합니다. 모든 그려진 순간은 style.md의 품질 기준을 통과해야 합니다(참조 이미지와 나란히 스틸 비교).
  • check.py 통과: 1080x1920, 30fps, H.264, -14 LUFS, 컷 후 0.25초 이상의 침묵 없음.

인계

  • <name>_vN.mp4의 경로, 게시 준비 완료. 매번 버전을 표시합니다(_v1, _v2...). 오래된 파일이 새 파일로 오인되지 않도록 합니다.
  • 간략한 컷 리스트(무엇이 왜 제거되었는지), 각 그래픽과 그 시간, 가정한 사항, 확인할 수 없었던 것.
  • 커버 텍스트를 위한 세 가지 짧은 후크 옵션과, 원한다면 게시물 캡션: 크리에이터의 언어, 첫 줄에 사람들이 검색할 단어, 짧은 줄, 문단 사이 빈 줄, 해시태그 벽 없음.

크리에이터의 메모

크리에이터는 당신에게 편집자처럼 말합니다("캡션 더 크게", "처음 5초 더 빠르게 컷", "내 앱 화면을 0:12에 넣어", "줌 덜 해"). 시간 "05:27"은 초:프레임(5초 + 27프레임)을 의미합니다. 메모를 적용하고, 다음 버전을 렌더링하고, 재검증한 후 새 파일을 제공합니다. 그런 다음 creator.md에 기록합니다: 해당 규칙이 속한 섹션, "Rejected" 아래의 "no", "Notes" 아래에 날짜가 포함된 한 줄. 새로운 종류의 그래픽은 전체 렌더링 전에 스틸로 2가지 방향을 보여주고, 크리에이터가 선택한 것을 기록합니다.

이미 경험한 함정

  • 휴대폰 영상은 종종 HDR(HLG)이고 회전되어 있습니다: cut.py가 톤 매핑하고 회전을 읽습니다. 크리에이터가 요청하지 않는 한 필터, LUT, "워밍업", 피부 보정을 절대 추가하지 마세요.
  • Whisper의 단어 타이밍은 0.1~0.3초 오차가 있습니다: transcribe.py의 정렬 없이 캡션이나 컷 타이밍을 절대 맞추지 마세요.
  • 인스타그램은 프로필 다운로드를 차단합니다. 단일 릴스 링크는 yt-dlp로 다운로드합니다.
  • 이모지는 시스템의 이모지 폰트(Mac의 경우 Apple 폰트)로 렌더링됩니다: 스틸로 확인하세요.
  • 렌더링 중 zod 관련 "버전 불일치" 경고는 무해합니다.
  • 작업 디렉토리를 변경하는 여러 셸 명령을 병렬로 실행하면 경합이 발생합니다: 절대 경로를 사용하세요.
  • Remotion은 개인 및 최대 3명의 회사에게 무료입니다. 더 큰 회사는 회사 라이선스가 필요합니다.

관련 스킬