Communitygithub.com

패널 투 릴스

긴 토크, 패널, 팟캐스트 또는 인터뷰 녹화를 단어별로 자막이 표시되는 세로 9:16 릴스와 인스타그램 그리드용 커버로 변환합니다. 두 가지 자막 스타일을 지원하며, 이미 편집된 세로 동영상(아이폰 HDR 포함)에도 자막을 입힐 수 있습니다.

패널 투 릴스란 무엇인가요?

이 스킬은 긴 영상(토크, 패널, 팟캐스트, 인터뷰)을 인스타그램 릴스, 쇼츠 등의 숏폼 콘텐츠로 자동 변환하는 AI 에이전트 도구입니다. Apple Silicon Mac에서 동작하며, `mlx-whisper`로 음성을 텍스트로 변환하고, Apple Vision을 이용해 화자의 얼굴을 추적하여 9:16 비율로 자동 크롭합니다. 두 가지 자막 스타일(빌드업 스타일과 브랜드 스타일)을 제공하며, 각 릴스에 맞는 인스타그램 프로필 그리드용 커버 이미지도 함께 생성합니다. 사용자는 긴 녹화본에서 하이라이트 구간을 선택하고, 자막 오류를 수정하며, 강조할 단어를 지정할 수 있습니다. 생성된 결과물은 검토 후 내보내집니다. Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add micahwburgess-spec/panel-to-reels

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

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

문서

패널 투 릴스은(는) 무엇을 하나요?

하나의 긴 녹화를 게시 준비가 완료된 여러 개의 세로 릴스로 변환합니다. 각 릴스는 단어 경계를 기준으로 잘리고, 화자의 얼굴을 중심으로 9:16 비율로 리프레이밍되며, 단어별로 자막이 표시되고, 인스타그램 프로필 그리드에 맞춰 제작된 커버와 함께 제공됩니다. 모든 클립은 두 가지 스타일로 렌더링됩니다: 빌드업(흰색 자막, 빨강/파랑/자주색 강조)과 브랜드(styles.json에 설정된 사용자 색상 및 글꼴).

스크립트는 기계적인 작업을 수행합니다. 품질은 이 파일에 명시된 판단 지침에서 비롯됩니다. 워크플로우를 순서대로 따르고 리뷰 게이트를 건너뛰지 마십시오.

요구 사항

  • Apple Silicon이 탑재된 Mac (얼굴 추적은 Apple Vision을 사용하고, 음성 변환은 GPU에서 mlx-whisper를 사용합니다).
  • libx264 및 libx265가 포함된 ffmpeg (brew install ffmpeg).
  • Python 3 (설치 스크립트가 ~/.panel-to-reels/에 자체 venv를 생성합니다).
  • 디스크: 90분 분량의 4K 소스는 약 6GB입니다.

이 스킬의 폴더에서 일회성 설정:

bash scripts/setup.sh

모든 스크립트는 래퍼를 통해 실행하여 올바른 Python을 사용하도록 합니다: bash scripts/run.sh <스크립트> <인수>. 각 스크립트의 정확한 명령줄은 scripts/USAGE.md에 있습니다.

워크플로우

프로젝트 폴더 P(어디든 영구적인 곳, macOS가 지우는 /tmp는 절대 안 됨)에서 작업합니다. 모든 스크립트는 첫 번째 인수로 P를 사용합니다.

1. 가능한 가장 높은 해상도로 소스 확보

run.sh fetch P <url> 또는 로컬 파일을 P/source.<확장자>로 복사합니다. 16:9 프레임의 9:16 크롭은 가로의 약 1/3만 유지하므로, 4K 입력은 선명한 릴스를 의미합니다. 1080p 소스도 작동하지만 확대 시 부드러워 보일 수 있습니다. 화면의 주인이 녹화본을 소유하고 있다면 원본 카메라 파일을 요청하세요. 업로드된 파일보다 훨씬 좋습니다.

2. 텍스트 변환

run.sh transcribe P --prompt "화자 이름, 회사 이름, 전문 용어". 프롬프트가 중요합니다: 이름이 훨씬 더 정확하게 나옵니다. 이 명령은 모든 줄 시작 부분에 단어 인덱스가 있는 transcript.txt를 만듭니다. 해당 인덱스로 클립을 선택합니다.

3. 참조 스타일이 있는 경우 먼저 분석

2~6개의 예시 게시물을 요청하세요. 인스타그램은 직접 다운로드를 차단하지만, 공개 임베드 페이지(instagram.com/reel/<id>/embed/captioned/)는 종종 하나의 동영상을 노출하고 항상 캡션 텍스트를 보여줍니다. 프레임을 캡처하고 다음을 기록하세요: 캡션 글꼴, 크기, 위치, 단어 표시 방식, 강조 색상, 커버 헤드라인 글꼴 및 레이아웃. 렌더링하기 전에 styles.json에 매핑하세요.

4. 전체 대본을 읽고 순간 선택

전체를 읽으세요. 전반부만 훑지 마십시오. 좋은 클립은:

  • 20초에서 80초 사이의 하나의 독립된 아이디어입니다.
  • 주장, 숫자, 질문 또는 이야기 전환점과 같은 강력한 문장으로 시작합니다. 가장 좋은 문장이 답변 중간에 있다면 거기서 시작하세요.
  • 결말이 명확하고, 생각 중간에 끝나지 않아야 합니다.

이 릴스를 만드는 대상(자신의 답변이 우선)에게 가중치를 두세요. 해당 이벤트나 다른 계정이 이미 게시한 순간은 건너뛰세요. 해당 인물에게 묻거나 링크를 확인하세요. 후보 목록을 표(클립, 화자, 후킹 라인, 타임스탬프)로 제시하고, 제작 전에 해당 인물이 삭제하거나 추가할 수 있도록 하세요.

5. 화자가 카메라에 있는지 확인 (건너뛰지 마세요)

모든 후보에 대해 run.sh peek P <시작> <종료>를 실행하세요. 멀티 카메라 편집은 종종 누군가 말하는 동안 리액션 샷이나 와이드 샷으로 전환됩니다. 규칙:

  • 클립의 대부분 동안 화자가 카메라에 없으면 삭제하세요. 세로 크롭은 다른 사람의 얼굴을 그들의 말 위에 놓이게 합니다.
  • 짧은 리액션 컷어웨이(클립의 약 1/3 미만)는 letterbox 모드로 유지할 수 있습니다: 와이드 샷이 흐릿한 채움 위에 배치되어 아무도 잘못 식별되지 않습니다.
  • 사람들은 옷차림과 앉은 위치로 식별한 다음, 대본(누가 소개되었는지, 누가 대답하는지)과 대조하여 확인하세요. 외모로 이름을 추측하지 마십시오.

6. 단어 인덱스 기준으로 자르기

각 클립을 P/clips.json에 작성하세요(스키마는 scripts/USAGE.md, 예시는 examples/clips.example.json에 있음).

  • spans는 포함적인 단어 인덱스 범위입니다. 여러 범위는 점프 컷을 만듭니다. 지루한 부분을 다듬는 데 사용하고, 의미를 바꾸는 데 사용하지 마세요.
  • fix는 확실한 전사 오류를 수정합니다("found"를 "pounded"로 말한 경우, "CLAUDE.md"를 의미하는 "Claude on a D file"). 빈 문자열은 단어를 삭제합니다.
  • 문구가 왜곡되어 무슨 말을 했는지 확실하지 않은 경우, 그 부분을 잘라내세요. 입에 단어를 억지로 넣지 마세요.
  • 클립이 진행자의 질문으로 시작하는 경우, 질문은 설정으로만 유지하세요. 진행자의 대사가 게스트의 대사처럼 읽히지 않도록 하세요.

7. 프레이밍

run.sh shots P <클립>은 카메라 컷(느린 디졸브 포함)을 찾고, 샷당 하나의 눈금선이 있는 프레임을 렌더링하며, 감지된 얼굴 중심을 출력합니다. 각 샷에 대해 화자의 x 좌표를 framing에 입력하세요.

  • crop은 소스 대비 크롭 높이 비율입니다: 34명의 미디엄 샷의 경우 약 0.62, 와이드 샷의 경우 0.420.5입니다.
  • 패닝하는 핸드헬드 카메라는 각 움직임에 대한 프레이밍 표시가 필요합니다. 트래커는 부드러운 움직임을 따르지만 빠른 휩은 놓칠 수 있습니다.
  • 가까이 앉은 이웃: 눈대중이 아닌 출력된 얼굴 중심의 정확한 x 좌표를 제공하세요.

8. 빌드 및 확인

run.sh build P <클립>을 실행한 다음, 각 기본 클립에서 10~16프레임을 가져오세요. 화자는 모든 프레임에서 프레이밍되어야 합니다. 프레이밍을 수정하고 자막 전에 다시 빌드하세요.

9. 자막, 강조 및 커버

  • 강조: emphasis에서 아이디어를 전달하는 단어(숫자, 이름, 요점이 닿는 명사)를 직접 선택하세요. 강조가 없는 자막 페이지는 자동으로 선택됩니다.
  • 헤드라인: 4~9단어, 말한 내용에 충실하고, 강력하게. 결말을 *별표*로 감싸서 악센트를 받도록 하세요. 화자가 말한 것보다 더 많이 주장해서는 안 됩니다.
  • 커버 프레임: 가능하면 입을 다문 화자가 렌즈를 바라보는 모습. 헤드라인이 입을 가리면 cover_shift를 높이세요(사진을 위로 슬라이드하고 가장자리를 페이드합니다).
  • 토킹헤드 셀카 영상은 패널 영상보다 프레임 아래쪽에 위치합니다: caption_center를 1430 근처로 설정하여 자막이 입이 아닌 가슴에 오도록 하세요.

10. 렌더링, 리뷰, 배포

run.sh render_all P는 모든 스타일의 모든 클립을 렌더링하고, P/export/<스타일>/로 내보내며, 확인 테이블을 출력합니다. 그런 다음 직접 리뷰하세요: 모든 커버의 연락처 시트(그리드 크기)와 각 릴스의 3~4프레임. 마지막으로, 각 클립에 대한 게시물 카피를 해당 인물의 목소리로 작성하세요. 인용문은 대본과 단어 단위로 일치해야 합니다. 확인된 핸들만 태그하세요. 알 수 없는 핸들은 [핸들]로 표시하여 해당 인물이 채우도록 하세요.

엄격한 규칙

  • 다른 사람에게 잘못된 말을 귀속시키지 마세요. 의심스러우면 클립을 삭제하세요.
  • 자막, 커버 및 게시물 카피의 인용문은 대본과 정확히 일치해야 합니다.
  • 타 조직의 이름이나 브랜딩을 해당 콘텐츠가 아닌 것에 넣지 마세요. 로고는 styles.json에서 제공됩니다. 프로젝트별로 설정하세요.
  • 헤드라인이나 카피에 허구의 숫자, 결과 또는 주장을 넣지 마세요.
  • 얼굴과 목소리는 실제 녹화본만 사용하세요. 화자를 생성하거나 복제하지 마십시오.

이미 편집된 세로 동영상

완성된 토킹헤드 동영상(아이폰 HDR 포함)의 경우, 자르기 및 프레이밍을 건너뜁니다: run.sh transcribe P --file <동영상> --clip <ID>, "source_file"이 설정되고 "caption_center": 1430이 포함된 클립을 clips.json에 추가한 다음, run.sh render_all P --clips <ID>를 실행하세요. fix 및 emphasis의 인덱스는 P/base/<ID>.words.txt에서 가져옵니다. 소스 파일은 절대 수정되지 않습니다.

스타일 및 로고

styles.json은 사전 설정을 보유합니다. 각 설정에는 label(내보내기 폴더 이름), caption 블록(글꼴, 크기, 자막 페이지당 순환하거나 그라데이션을 이루는 하이라이트 색상, 필 색상) 및 cover 블록(강조 색상, 하단 틴트, 로고 라인, 구분선, 선택적 블룸)이 있습니다. 이를 P에 복사하고 편집하여 프로젝트를 사용자 정의하세요. examples/summit-oak-styles.json은 완전히 브랜딩된 설정을 보여줍니다. 글꼴은 이 스킬의 fonts/ 폴더에서 파일 이름으로 로드됩니다. 가변 글꼴은 "Sora:ExtraBold" 구문을 사용합니다.

로고는 모든 커버 헤드라인 아래의 두 줄입니다. 스타일에서 설정하고 clips.json에서 "lockup": ["첫 번째 줄", "두 번째 줄"]로 클립별로 재정의할 수 있습니다. 이벤트 클립은 이벤트를 표시합니다. 개인의 동영상은 자신의 이름과 브랜드를 표시하며, 이벤트의 이름을 표시하지 않습니다.

힘들게 얻은 교훈

  • 아이폰 영상은 HDR(HLG)입니다. 일반 sRGB 그래픽을 오버레이하면 그래픽이 빛나고 채도가 과도해집니다. 스크립트는 HLG를 감지하고 자막을 HDR로 변환하며 10비트 HEVC 출력을 유지합니다. Finder 또는 일반 ffmpeg로 가져온 미리보기는 어둡고 평평해 보입니다. hlg.frame() 스틸 또는 휴대폰에서 판단하세요.
  • ffprobe csv 출력에는 후행 쉼표가 있을 수 있습니다 (arib-std-b67,). in으로 비교하거나 제거하세요.
  • 편집된 패널은 종종 하드 컷 대신 디졸브를 사용합니다. 장면 점수 감지는 이를 놓칩니다. shots.py의 프레임 차이 감지기가 이를 포착합니다.
  • 흰색 자막은 흰색 앱 화면에서 사라집니다. 자막 뒤의 배경이 밝으면 자동으로 어두운 필이 생깁니다.
  • Whisper는 토큰을 분할합니다(예: $2 ,400, 80 %). 자막은 이를 다시 붙이므로 강조 인덱스는 첫 번째 조각을 가리킵니다.
  • 인스타그램은 프로필 그리드에서 커버를 3:4로 자릅니다(1920의 y 240~1680). 모든 커버 텍스트를 해당 대역 내에 유지하세요.
  • macOS는 며칠 후 /tmp를 지웁니다. 프로젝트와 venv를 영구적인 곳에 보관하세요.
  • 일부 ffmpeg 빌드에는 drawtext가 없고 일부 Intel 빌드는 하드웨어 인코더를 사용할 수 없습니다. 스크립트는 모든 텍스트에 PIL을 사용하고 HDR에 libx265를 사용하므로 어느 쪽이든 작동합니다.

Micah Burgess, Summit Oak AI 제작. summitoakai.com

관련 스킬