/long-form
source ──tighten──▶ tight take ──build──▶ edited.mp4 + .srt + .chapters.txt + .sheet.jpg
(pauses cut, ├ plain stretches: punch-ins on the cuts, captions, chapter cards
words remapped) └ moments: explainer / split-screen / ... rendered and spliced in
첫 사용
이 스킬의 폴더는 Claude Code가 로드할 때 표시하는 "Base directory"입니다.
SKILL_DIR="<base directory of this skill>" # Claude Code가 "Base directory for this skill"로 출력한 경로
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout
GROQ_API_KEY가 설정되어 있어야 음성 인식(긴 동영상은 10분 단위로 처리)이 가능합니다. ffmpeg와 Node가 필요합니다.
단계
- 조사.
"$PY" "$KIT/reel.py" probe <video>: 크기, 길이 및auto가 선택할 형식(가로가 세로보다 넓으면 가로 1920x1080, 그렇지 않으면 세로 1080x1920)을 출력합니다. 사용자가 다른 모양을 원하는 경우에만 묻습니다(가로 소스를 세로로 자르면 중앙이 크롭됨). - 정리 (원본 녹화물에 권장, 이미 편집된 영상은 건너뛰기):
"$PY" "$KIT/longform.py" tighten <video> [--max-gap 0.45] [--pad 0.12] [--cut-fillers]음성 인식으로 모든 단어를 유지하고,--max-gap보다 긴 각 멈춤을 약2 × --pad로 줄인 후<video>.tight.mp4와<video>.tight.transcript.json(새 타임라인의 단어 및 각 조인 위치의cuts)를 씁니다. 그 다음부터는 정리된 파일을 사용합니다.--cut-fillers는 음/어/음을 제거합니다. - 읽기.
"$PY" "$KIT/reel.py" words <video>는 각 문장을 시간과 함께 한 줄씩 출력합니다(정리했다면 정리된 타임라인 기준). 긴 동영상은--start/--end로 부분적으로 읽습니다. 다음을 기록합니다:- 챕터: 주제가 바뀌는 지점(10
20분 동영상에 410개), 각각 2~5단어 제목; - 모먼트 2
6개: 410초 길이로, 하나의 구체적인 시각적 포인트(비교, 단계, 숫자, 순위, 짧은 이야기)를 만듭니다. 고르게 분포시키고, 대부분의 동영상은 일반 테이크로 유지됩니다.
- 챕터: 주제가 바뀌는 지점(10
- 프레이밍.
"$PY" "$KIT/reel.py" frame <video> <t> frame.jpg를 실행해서 확인합니다: 얼굴 중심(펀치인에 사용되는face)과 모먼트에 필요한 눈선 및 얼굴 x 좌표(eye_y,face_x,video_top등)를 기록합니다. - 명세. 동영상 옆에
<video>.long-form.json을 작성합니다(아래 참조). 경로는 명세 파일 기준 상대 경로입니다. - 빌드.
"$PY" "$SKILL_DIR/build.py" <spec.json>을 실행합니다. 모먼트가 먼저 렌더링되고(약 2040초, 캐시됨), 그런 다음 타임라인이 병렬로 세그먼트 단위로 인코딩됩니다. 15분 1080p 동영상은 대략 ffmpeg 패스 12회 정도의 시간이 소요됩니다. - 확인
<out>.sheet.jpg를 보고(12프레임, 빨간색은 플레이어 또는 릴 UI에 가려진 영역), 동영상에서 각 모먼트의 조인 지점과 챕터 카드 하나를 점검합니다. 명세를 수정하고 다시 빌드하며, 변경되지 않은 모먼트는 재사용됩니다. - 전달 mp4,
.srt(자막이 입혀져 있어도 YouTube에 업로드하여 검색 가능한 캡션으로 사용),.chapters.txt(설명에 붙여넣기)를 제공합니다.
명세
{
"video": "episode.tight.mp4",
"format": "auto",
"out": "episode.edited.mp4",
"face": [880, 400],
"punch_ins": {"every": "cut", "scale": 1.12, "min_hold": 2.5},
"zooms": [{"start": 312.4, "end": 318.0, "scale": 1.25}],
"captions": {"keys": ["carousel", "viral"], "karaoke": false},
"chapters": [
{"at": 0, "title": "Why carousels win"},
{"at": "the second thing", "title": "Finding a viral post"}
],
"moments": [
{"skill": "explainer", "start": 61.2, "end": 67.0,
"title": "Steal what *works*", "eye_y": 400, "face_x": 880,
"visual": {"type": "list", "items": [{"text": "Find a *viral* post", "at": "find"}, {"text": "Recreate it", "at": "recreate"}]}},
{"skill": "split-screen", "start": 140.0, "end": 147.5, "face_x": 880, "zoom": 1.2,
"badge": "Step 2", "headline": "Pick *one*", "visual": {"type": "image", "src": "screens/app.png"}}
],
"loudness": -14
}
video: 정리된 파일 또는 원본 파일.start/end(선택사항)를 사용하면 일부만 사용합니다.format:auto,horizontal또는vertical.face: 캔버스 상의 얼굴[x, y], 모든 줌의 중심입니다. 기본값: 중앙, 약간 위.punch_ins: 일반 샷과scale(1.08~1.18) 사이를 매"cut"(정리된 대본 필요, 점프 컷을 숨김), 매"sentence", 또는 매 N초(숫자)마다 전환합니다.min_hold(초)는 줌이 깜빡이는 것을 방지합니다. 펀치인이 필요 없으면 생략합니다.zooms: 펀치인 위에 추가되는 명시적 유지 구간입니다. 강조가 필요한 대목에만 드물게 사용합니다.captions: 입혀진 기본 자막: Inter ExtraBold, 흰색에 부드러운 그림자,keys는 악센트 배경 위에 표시됩니다.karaoke: true는 아직 말하지 않은 단어를 어둡게 합니다.y와size로 위치와 크기를 조정합니다.false는 입혀진 자막을 끕니다(여전히.srt는 생성됨). 모먼트 내부에서는 모먼트 자체 자막이 우선합니다.chapters:at은 초 단위 시간 또는 말한 단어("pricing","pricing#2","pricing-0.5")입니다. 각각 약 3초 동안 카드(악센트 번호 타일과 제목)가 표시됩니다. 하나에"card": false를 주거나 전체에"chapter_cards": false를 주면.chapters.txt항목만 남깁니다. 0에 없는 첫 번째 챕터는 "Intro" 줄(intro_title)을 얻습니다.moments:skill+start/end(초 또는 단어) + 해당 스킬의 자체 필드(해당 SKILL.md에 정확히 설명됨, 작성하기 전에 읽어보세요). 형식, 동영상 및 대본은 자동으로 채워집니다. 모먼트는 겹칠 수 없습니다. 컷아웃 스킬(explainer, behind-the-person)은 프레임당 약 0.1초를 추가합니다.loudness: 최종 믹스를 이 LUFS로 정규화합니다(-14는 YouTube에 적합). 생략하면 녹음된 음성을 그대로 유지합니다.keep_work: true로 설정하면 인코딩된 세그먼트를.work/에 보관합니다.
감각
- 테이크가 쇼입니다. 자막과 펀치인이 전체 동영상을 이끌어가고, 모먼트는 양념과 같습니다(최대 1~3분에 하나씩).
- 모든 모먼트는 그 아래의 정확한 문장을 시각화하며, 그 문장을 명명하는 단어에 맞춰 사용자의 실제 이미지, 스크린샷, 숫자를 사용합니다. 결과를 절대 만들어내지 마십시오.
- 챕터 제목은 짧고 구체적입니다("Pricing", "The 3-step setup"). 클릭베이트 스타일은 안 됩니다.
- 가로: 자막과 카드를 안전 영역 안에 유지하세요(시트에 표시됨). YouTube의 진행률 표시줄은 일시 정지 시 하단 120px을 가립니다.
- 세로 긴 형식은 릴과 동일한 영역을 사용합니다. 자막은 y 1380 주변에 유지하세요.