Communitygithub.com

long-form

긴 토크형 영상(수평 16:9 YouTube 또는 수직 9:16)을 처음부터 끝까지 편집합니다. 긴 멈춤을 줄이고, 필요시 음/어를 제거하며, 교차 줌으로 점프 컷을 숨기고, 강조 단어에 악센트 필이 있는 자막을 입히고, 챕터 카드를 추가하며, 다른 스킬(explainer, split-screen, behind-the-person, ranking-list, storytelling)로 만든 디자인 '모먼트'를 정확한 프레임에 삽입합니다. 또한 .srt 자막 파일과 YouTube 챕터 목록을 생성합니다. 사용자가 /long-form을 실행하거나 전체 동영상, 팟캐스트 스타일 토크, YouTube 동영상, 강의 또는 약 1분 이상의 클립 편집을 요청할 때 사용하세요.

long-form란 무엇인가요?

이 스킬은 1분에서 1시간 길이의 토크형 영상을 전문적으로 편집하는 AI 에이전트용 도구입니다. 수평(1920x1080) 및 수직(1080x1920) 형식을 모두 지원하며, 긴 녹화물의 불필요한 멈춤(pause)을 자동으로 줄이고, 선택적으로 '음', '어' 같은 필러 단어를 제거합니다. 점프 컷을 자연스럽게 감추기 위해 교차 줌 인(punch-in zoom) 효과를 적용하고, 강조할 키워드에는 악센트 배경이 있는 깔끔한 자막을 입힙니다. 또한 설명, 분할 화면, 인물 뒤에 표시, 순위 목록, 스토리텔링 등 다른 스킬로 제작한 특별 시각 효과를 정확한 타임라인 지점에 삽입할 수 있습니다. `tighten` 명령어로 원본을 1차 가공한 후, JSON 명세 파일을 작성하여 원하는 편집 사양을 정의하고, `build` 명령어로 최종 동영상(.mp4), 자막(.srt), 챕터 목록(.chapters.txt), 미리보기 이미지(.sheet.jpg)를 생성합니다. 사용자는 Groq API(음성 인식), ffmpeg, Node.js가 필요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/long-form

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

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

문서

/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가 필요합니다.

단계

  1. 조사. "$PY" "$KIT/reel.py" probe <video>: 크기, 길이 및 auto가 선택할 형식(가로가 세로보다 넓으면 가로 1920x1080, 그렇지 않으면 세로 1080x1920)을 출력합니다. 사용자가 다른 모양을 원하는 경우에만 묻습니다(가로 소스를 세로로 자르면 중앙이 크롭됨).
  2. 정리 (원본 녹화물에 권장, 이미 편집된 영상은 건너뛰기): "$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는 음/어/음을 제거합니다.
  3. 읽기. "$PY" "$KIT/reel.py" words <video>는 각 문장을 시간과 함께 한 줄씩 출력합니다(정리했다면 정리된 타임라인 기준). 긴 동영상은 --start/--end로 부분적으로 읽습니다. 다음을 기록합니다:
    • 챕터: 주제가 바뀌는 지점(1020분 동영상에 410개), 각각 2~5단어 제목;
    • 모먼트 26개: 410초 길이로, 하나의 구체적인 시각적 포인트(비교, 단계, 숫자, 순위, 짧은 이야기)를 만듭니다. 고르게 분포시키고, 대부분의 동영상은 일반 테이크로 유지됩니다.
  4. 프레이밍. "$PY" "$KIT/reel.py" frame <video> <t> frame.jpg를 실행해서 확인합니다: 얼굴 중심(펀치인에 사용되는 face)과 모먼트에 필요한 눈선 및 얼굴 x 좌표(eye_y, face_x, video_top 등)를 기록합니다.
  5. 명세. 동영상 옆에 <video>.long-form.json을 작성합니다(아래 참조). 경로는 명세 파일 기준 상대 경로입니다.
  6. 빌드. "$PY" "$SKILL_DIR/build.py" <spec.json>을 실행합니다. 모먼트가 먼저 렌더링되고(약 2040초, 캐시됨), 그런 다음 타임라인이 병렬로 세그먼트 단위로 인코딩됩니다. 15분 1080p 동영상은 대략 ffmpeg 패스 12회 정도의 시간이 소요됩니다.
  7. 확인 <out>.sheet.jpg를 보고(12프레임, 빨간색은 플레이어 또는 릴 UI에 가려진 영역), 동영상에서 각 모먼트의 조인 지점과 챕터 카드 하나를 점검합니다. 명세를 수정하고 다시 빌드하며, 변경되지 않은 모먼트는 재사용됩니다.
  8. 전달 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 주변에 유지하세요.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬