긴 영상을 쇼츠로 바꾸는 클로드 스킬 · 파일 + 설치법 + 요청문

스킬 파일 받기

⬇ longform-shorts.zip 내려받기

이 스킬이 하는 일

긴 영상(유튜브 링크 또는 mp4 파일)을 주면 25~45초짜리 세로 쇼츠 한 편(final.mp4)을 만들어요.

• 영상 전체를 받아쓰기해요. –asr local을 붙이면 내 맥에서 무료로 받아써요. 따로 키가 필요 없어요.
• 가장 궁금해지는 한 줄을 골라 맨 앞에 놓아요
• 말이 중간에 끊기지 않게 단어가 끝나는 자리에서만 잘라요
• 대사 자막을 자동으로 넣어요
• 얼굴을 찾아서 얼굴을 따라가며 세로 화면으로 잘라요
• 위에는 제목을 넣고 아래에는 로고와 제목을 넣어요
• 큰 글자·확대·박스·화면 나누기처럼 화면 효과를 바꿔 가며 넣어요
• 원본 영상에 박혀 있는 자막 띠를 지워서 자막이 두 번 나오지 않게 해요

원하면 내 목소리로 내레이션도 얹을 수 있어요. 아래에 따로 적었어요.

준비물

• 맥(맥 기준으로 만들고 확인했어요. 윈도우와 리눅스는 확인하지 않았어요)
• 설치하고 로그인한 클로드 코드 또는 코덱스 CLI
• uv와 ffmpeg. ffmpeg는 자막을 그리는 ass 필터(libass)가 들어 있어야 해요. 없으면 자막 넣기에서 멈춰요.
• 받아쓰기·얼굴 찾기 모델을 받을 디스크 몇 GB

설치

1. zip을 풀어서 oaiwan-longform-shorts 폴더를 ~/.claude/skills/ 안에 넣어요.
2. 클로드 코드를 새로 열고 /skills를 입력해 oaiwan-longform-shorts가 보이면 끝이에요.

쇼츠 만들기

쇼츠를 저장할 폴더에서 클로드 코드를 열고 아래 요청문을 붙여 넣어요. 링크 자리에 유튜브 주소나 영상 파일 경로를 넣어요.

oaiwan-longform-shorts 스킬로 이 영상을 쇼츠로 만들어 줘: <링크>
받아쓰기는 --asr local로 해 줘.

클로드가 아래 명령을 대신 실행해요. 직접 실행해도 돼요.

scripts/run.sh --input <URL 또는 파일> --agent claude --out <폴더> --asr local

• –agent: 클로드 코드면 claude, 코덱스면 codex
• –out: 결과를 담을 폴더. 끝나면 <폴더>/final.mp4가 생겨요
• –asr local: 내 맥에서 무료로 받아쓰기
• –range 시작-끝: 이 구간(초)에서만 고르기. 예: –range 600-1200
• –title “하단 제목”: 아래쪽 제목을 직접 정하기

내 목소리 내레이션

내 목소리를 흉내 내는 GPT-SoVITS를 내 맥에 설치해서 씁니다. 무료이고 인터넷에 목소리를 올리지 않아요.

1. 설치 (한 번만, 약 3GB를 받아요)

oaiwan-longform-shorts 스킬의 scripts/setup_sovits.sh로 GPT-SoVITS를 설치해 줘.

~/gpt-sovits에 uv로 설치해요. 다른 프로그램을 따로 깔거나 관리자 비밀번호를 넣을 일은 없어요.

2. 내 목소리 녹음

• 조용한 방에서 3~10초만 녹음해요
• 읽을 문장을 먼저 정하고 그 문장을 그대로 읽어요. 예: “안녕하세요 오늘은 긴 영상을 쇼츠로 바꿔 볼게요”
• wav 파일로 저장하고 읽은 문장도 적어 둬요

3. 내레이션 만들고 쇼츠에 얹기

내 목소리 내레이션을 만들어서 final.mp4에 얹어 줘.
녹음 파일은 내목소리.wav, 녹음에서 읽은 문장은 "안녕하세요 오늘은 긴 영상을 쇼츠로 바꿔 볼게요".
읽을 문장은 "이 장면 하나로 영상 전체가 궁금해져요".

클로드가 아래 두 명령을 실행해요.

scripts/narrate.sh --ref 내목소리.wav --ref-text "<녹음에서 읽은 문장 그대로>" --text "<읽을 문장>" --out narration.mp3
scripts/add_narration.sh final.mp4 narration.mp3 out.mp4

• 읽을 문장이 여러 개면 –text를 여러 번 적어요
• add_narration.sh는 원본 소리를 줄이고 내레이션을 위에 얹어요

막힐 때

• 자막 넣기에서 멈춰요: ffmpeg에 ass 필터가 없는 경우예요. libass가 들어 있는 ffmpeg로 다시 설치해요.
• 내 목소리와 안 닮았어요: 녹음이 3~10초인지 확인해요. –ref-text는 녹음에서 읽은 말과 글자 하나까지 똑같아야 해요.
• 발음이 이상해요: –seed 숫자를 바꿔서 다시 만들어요. 예: –seed 7

저작권

• 남의 영상은 출처와 이용 허락(라이선스)을 먼저 확인하고 써요. 허락 범위 안에서만 쓰고 출처를 꼭 밝혀요.
• 소개 영상의 예시는 KAIST 유튜브 「허준이 교수와의 대화」예요. CC BY 라이선스라서 출처를 밝히고 썼어요.