Communitygithub.com

raw-to-reel

원시 수평 영상(Hinglish 또는 영어, 세로 9:16)을 Remotion으로 편집된 인스타그램 릴스로 변환합니다 – 무음 제거, 펀치인 줌, 3D 타이틀, 터미널 패널, 라이트 릭, 효과음, 팔로우 카드. 사용자가 원시 영상을 제공하고 릴스, 쇼츠, 편집 또는 '이 참고 릴스처럼 만들어 줘'라고 요청할 때 사용합니다.

raw-to-reel란 무엇인가요?

이 스킬은 원시 talking-head 영상(Hinglish 또는 영어, 세로 9:16)을 Remotion 기반의 세련된 인스타그램 릴스로 자동 편집해 주는 AI 어시스턴트입니다. 주 용도는 사용자가 제공한 원시 영상을 릴스, 쇼츠, 편집 또는 '이 참고 릴스처럼'이라고 요청할 때 사용합니다. macOS, Linux, Windows WSL에서 작동하며, 사전 설정된 프로젝트 구조와 스크립트를 통해 무음 제거, 펀치인 줌, 3D 타이틀, 터미널 패널, 라이트 릭, 효과음, 팔로우 카드 등을 자동으로 적용합니다. 작업 흐름은 프로젝트 생성, 전사(transcribe), 무음 제거, 비트 시트 작성, 빌드, 타입 검사, 시각 검사, 사운드 검사, 미리보기, 그리고 최종 렌더링 순서로 진행됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트에서 사용하도록 설계되었으며, OpenCode 플러그인과의 호환성을 제공합니다. 사용자는 자연어 명령으로 효과음 볼륨 조절, 키보드 사운드 변경, 특정 사운드 제거 등을 요청할 수 있으며, 각 명령에 대한 정확한 처리 방법이 문서화되어 있습니다. AI 에이전트는 이 스킬의 엄격한 규칙(예: 각 오버레이의 시간을 `work/words.txt`에서만 가져오기, 얼굴 안전 영역 유지, 사용자 허락 없이 다운로드 금지 등)을 따라야 하며, 자체적인 스타일 발명을 금지합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

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

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

문서

원시 영상에서 릴스로 (Reel from raw video)

두 개의 릴스에서 검증됨: Linux Day 2 및 Linux Day 1 (효과음 포함). library/Reel.tsx는 Day 1 릴스입니다. 그 패턴을 복사하세요. 새로운 스타일을 발명하지 마세요.

macOS 및 Linux / Windows WSL에서 작동합니다. 설정: 저장소의 README.md를 참조하세요.

엄격한 규칙

  1. 모든 오버레이는 work/words.txt 초 단위로 시간을 맞춥니다. 시간을 절대 추측하지 마세요.
  2. src/ (library)에 있는 컴포넌트만 사용합니다. 라이브러리 컴포넌트가 비트(beat)에 맞지 않을 때만 새 컴포넌트를 추가합니다.
  3. 얼굴을 명확히 유지합니다. 안전 영역(1080x1920):
    • 상단 태그 및 타이틀: y 90~400.
    • 얼굴 및 목: y 약 450~1350. 여기에는 전체 화면 타이틀 카드(최대 3초)만 가능합니다.
    • 그 외 모든 것은 목 아래(셔츠의 첫 번째 단추)로 배치: y 1360~1880. Panel은 BELOW_NECK(1360)에서 시작합니다. fit을 사용하여 긴 패널을 1880까지 끝나도록 크기를 조정합니다.
    • 각 새 비디오의 목선을 찾습니다: y-그리드가 있는 프레임을 캡처하여 확인합니다. ui.tsx에서 BELOW_NECK을 업데이트합니다.
  4. 사용자가 채팅에서 요청하지 않는 한 전체 비디오를 렌더링하지 마세요. scripts/stills.sh를 사용하여 확인합니다. 후크가 RENDER_OK=1 없이 remotion render를 차단합니다.
  5. 사용자에게 묻지 않고 어떤 것도(모델, 폰트, 음악, 사운드 팩) 다운로드하지 마세요.
  6. 디버깅하기 전에 reference/known-problems.md를 읽으세요.
  7. OpenCode에서 플러그인 ~/.config/opencode/plugins/reel-from-raw는 Claude 후크(렌더 차단, 타입 검사, 스틸 미리 알림)와 동일한 작업을 수행합니다. 시트 이미지를 읽기 도구로 엽니다. 모델이 이미지를 볼 수 없으면 사용자에게 시트를 확인하도록 요청하세요.

범위 규칙(정확히 따릅니다)

  1. 사용자가 요청한 것만 수행합니다. 요청에 필요한 파일과 값만 변경합니다.
  2. 검사(타입 검사, 스틸 검사, 후크 또는 플러그인의 미리 알림)는 검사일 뿐입니다. 이 파일 또는 reference/style-spec.md의 규칙을 위반하는 것만 수정합니다. 검사 때문에 스타일을 변경하거나, 컴포넌트를 추가하거나, 장면을 추가하거나, 텍스트, 타이밍 또는 볼륨을 변경하지 마세요.
  3. 다른 것을 변경해야 한다고 생각되면 한 줄로 사용자에게 알리세요. 변경하지 마세요.
  4. 비디오 작업 중에는 ~/.claude/skills/reel-from-raw/(이 스킬)를 편집하지 마세요. 비디오 프로젝트만 편집합니다.
  5. 생성한 테스트 파일(예: src/__probe.ts)은 완료 전에 삭제해야 합니다.

작업 흐름 (새 비디오)

각 단계를 실행합니다. 각 스크립트는 성공 시 OK:를 출력합니다. ERROR가 발생하면 중지하고 수정합니다.

#단계명령어 / 동작
1프로젝트 생성bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (예: ~/Coding/motion-videos/<name>). 라이브러리, 사운드 파일 및 후크를 복사하고 npm 패키지를 설치합니다(또는 $REEL_SEED에서 복제).
2전사bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (영어만 있으면 en 사용). 그런 다음 reference/glossary.md로 오청을 수정합니다.
3무음 제거python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. --start/--end를 사용하여 잘못된 시작 또는 꼬리를 제거합니다.
4비트 시트reference/beat-sheet-prompt.md를 따릅니다. work/beats.md를 작성합니다. 사용자가 계획을 승인하려면 보여줍니다.
5빌드src/Reel.tsx는 Day 1 릴스입니다. 비트 시트에서 다시 작성합니다. Root.tsx에서 id(예: LinuxDay3)와 실제 handle을 설정합니다. 릴스에서 사용하지 않는 장면 컴포넌트를 삭제합니다. At 및 r() 헬퍼를 유지합니다.
6타입 검사자동: 후크가 각 편집 후 tsc --noEmit을 실행합니다. 보고된 모든 오류를 수정합니다.
7시각 검사bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto를 실행한 다음 모든 out/stills/sheet*.jpg를 읽습니다. 또한 비트 프레임을 확인합니다: stills.sh <dir> 120,450,.... reference/style-spec.md와 대조하여 확인합니다. 수정하고 반복합니다.
8사운드 검사효과음은 컴포넌트와 함께 제공됩니다("효과음" 참조). public/sfx/typing.wav 및 public/sfx/pop.wav가 있는지 확인합니다. 사용자가 요청하지 않는 한 표 외부의 사운드를 추가하지 마세요.
9미리보기프로젝트에서 npx remotion studio --no-open --port <free>를 실행하는 launch.json 항목을 추가합니다. 사용자에게 URL http://localhost:<port>를 제공합니다. 사용자는 그곳에서 사운드를 듣습니다.
10렌더링(요청 시에만)RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle (백그라운드에서 실행, 90초에 약 3-5분 소요).

효과음

src/sfx.tsx는 모든 사운드를 보유합니다. SFX는 사운드를 나열합니다. <Sfx src at volume frames name>은 현재 시퀀스에서 at 프레임에서 하나의 사운드를 재생합니다.

SFX의 키출처인터넷 필요
whoosh, ding, click, switch, whip@remotion/sfx (remotion.media의 파일)예, Studio 및 렌더링용
poppublic/sfx/pop.wav (코드로 생성)아니요
typingpublic/sfx/typing.wav (scripts/make-typing-sound.py로 생성)아니요

라이브러리 컴포넌트는 이미 이러한 사운드를 재생합니다. 수동으로 추가하지 마세요.

순간파일 (프로젝트 내)사운드볼륨
후크 타이틀 / 서브 칩scenes/Intro.tsx (Hook)whoosh / whip0.54 / 0.48
Day 타이틀 카드scenes/Intro.tsx (DayTitle)whoosh / ding0.6 / 0.36
명령어 목록 칩scenes/Intro.tsx (CommandList)칩당 pop0.36
명령어 태그 / 명령어 이름scenes/Commands.tsx (CommandTag)whoosh / switch0.54 / 0.48
메모장 줄scenes/Commands.tsx (NoteCard)줄당 typing0.6
하단 패널 표시ui.tsx (Panel)pop0.48
터미널 명령어 입력ui.tsx (Terminal)각 명령어 줄에 typing0.6
라이트 릭Reel.tsxwhoosh0.48
완료 배지 / 팔로우 클릭scenes/Outro.tsx (DayDone, FollowCard)ding / click0.48 / 0.72
volume이 없는 모든 <Sfx>sfx.tsx (기본값)-0.42

볼륨은 0(무음)에서 1(전체)까지입니다. 모든 사운드를 음성 아래로 유지합니다.

일반적인 요청 (정확한 레시피)

사용자 요청정확히 이렇게 수행
"모든 효과음을 N% 증가/감소"<Sfx 줄의 모든 volume={x}와 sfx.tsx의 기본값을 (1 ± N/100)로 곱합니다. 소수점 2자리로 반올림합니다. CutVideo.tsx는 건드리지 마세요(음성입니다). 변경 전후에 grep -rn "<Sfx" src를 실행하고 변경된 값을 보여줍니다.
"키보드/타이핑 사운드 볼륨만 변경"src={SFX.typing}이 있는 줄만 변경합니다(ui.tsx Terminal 및 scenes/Commands.tsx NoteCard).
"특정 사운드 X만 변경"위 표에서 해당 행을 찾습니다. 해당 volume만 변경합니다.
"키보드 사운드가 약함/새로 만들기"python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav. 먼저 이전 파일의 복사본을 보관합니다. 사용자가 다른 느낌을 요청하는 경우에만 스크립트의 숫자를 편집합니다.
"사운드 제거"해당 <Sfx .../> 줄을 삭제합니다.
"렌더링 전에 어디서 들을 수 있나요?"Studio(9단계). 재생 또는 Space를 누릅니다. Studio는 각 저장된 편집 후 자동으로 다시 로드됩니다.
"직접 렌더링하려면 어떻게 하나요?"터미널: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle. Studio UI: 렌더 버튼(타임라인 위 막대 오른쪽 끝) → 비디오 탭 → 출력 이름 설정 → 비디오 렌더링. 진행 상황은 Jobs 탭에 표시됩니다. OpenGL 설정은 이미 angle입니다.
"렌더링해줘"10단계, RENDER_OK=1 포함. 그런 다음 출력 파일의 전체 경로를 제공합니다.
"핸들 변경"Root.tsx defaultProps.handle.

타이밍 작동 방식

  • src/timeline.ts: CUTS (제거된 원시 초), out(sec)은 원시 초를 출력 프레임에 매핑합니다.
  • <At from={rawSec} to={rawSec} name="...">는 해당 말하는 범위에 대한 블록을 표시합니다.
  • r(t0, t)는 블록 내에서 프레임 지연을 제공합니다. "t에서 단어가 말해질 때 이걸 팝업"과 같은 용도입니다.
  • CutVideo는 세그먼트당 줌 1.0 / 1.14를 번갈아 적용합니다(각 컷에 펀치인). 더 많은 줌을 추가하지 마세요.

라이브러리 맵

파일내보내기용도
theme.tsDISPLAY (Anton), SANS (Inter), MONO, 색상 C, extrude()모든 텍스트 및 색상. 새 글꼴이나 색상 없음.
sfx.tsxSFX, Sfx효과음 (위 참조)
ui.tsxPop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal스프링 팝인, 하단 절반 패널, 타이핑된 터미널
scenes/Intro.tsxHook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak오프닝, 섹션 전환
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard섹션당 하나의 주제: 상단 태그, Panel의 시각 자료
scenes/Commands.tsx (Day 2, 하드코딩된 텍스트)IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch재사용하기 전에 텍스트에 대한 props 추가
scenes/Outro.tsxDayDone({day}), NextDay({day, commands, at}), FollowCard({handle})종료 (NextDay는 선택 사항)
Reel.tsxReel전체 Day 1 릴스. 구조의 예로 사용합니다.

텍스트를 변경할 때 크기, 색상 및 애니메이션을 유지합니다.

관련 스킬