{"skill":{"slug":"youtube-clipper-ko","displayName":"Youtube Clipper Ko","summary":"한국어 YouTube 영상을 바이럴 클립으로 자동 분할하는 스킬. Whisper로 음성 분석 → Claude로 바이럴 구간 선정 → ffmpeg으로 클립 추출. 무음/숨소리 구간 제거, 3색 한국어 자막(SUIT 폰트), 바이럴 점수 + 리즌 텍스트 포함. YouTube URL 또...","description":"---\nname: youtube-clipper-ko\ndescription: >\n  한국어 YouTube 영상을 바이럴 클립으로 자동 분할하는 스킬.\n  Whisper로 음성 분석 → Claude로 바이럴 구간 선정 → ffmpeg으로 클립 추출.\n  무음/숨소리 구간 제거, 3색 한국어 자막(SUIT 폰트), 바이럴 점수 + 리즌 텍스트 포함.\n  YouTube URL 또는 로컬 파일 입력 지원. Clawitzer 파이프라인 연결 가능.\ntriggers:\n  - youtube 클립\n  - 영상 클리핑\n  - 바이럴 구간 추출\n  - 쇼츠 변환\n  - 롱폼 쇼츠\n---\n\n# YouTube Clipper KO\n\n한국어 YouTube 영상 → 바이럴 숏폼 클립 자동 분할기.\n\n## 개요\n\n1. YouTube URL 또는 로컬 영상 파일 입력\n2. yt-dlp로 영상 다운로드\n3. Whisper API로 전체 자막 + word-level 타임스탬프 추출\n4. Claude Haiku로 바이럴 구간 8~12개 선정 + 점수 + 한국어 리즌\n5. ffmpeg으로 각 구간 9:16 클립 추출\n6. 무음/숨소리 압축 (max_gap_sec=0.06)\n7. 3색 한국어 자막 burn-in (SUIT ExtraBold)\n8. 결과 폴더에 클립 + 메타데이터 JSON 저장\n\n## 필수 도구 확인\n\n에이전트는 작업 시작 전 반드시 환경을 확인해야 한다:\n\n```bash\n# yt-dlp\nyt-dlp --version\n\n# ffmpeg (libass 포함 여부 확인)\nffmpeg -filters 2>&1 | grep subtitles\n\n# python 의존성\npython3 -c \"import openai, anthropic; print('OK')\"\n\n# SUIT 폰트\nls /usr/share/fonts/truetype/SUIT-ExtraBold.ttf 2>/dev/null || echo \"MISSING\"\n```\n\n없으면:\n- yt-dlp: `pip install yt-dlp`\n- ffmpeg: `apt install ffmpeg` 또는 `brew install ffmpeg`\n- 의존성: `pip install openai anthropic`\n- SUIT 폰트 없으면 NotoSansCJK-Bold.ttc fallback 자동 적용\n\n## 사용법\n\n에이전트는 사용자에게 다음을 물어야 한다:\n\n1. YouTube URL 또는 로컬 영상 경로\n2. 구간 설정 (선택, 기본: 전체)\n3. 클립 길이 (선택: 15~30초 / 30~60초 / 60~90초 / 90~120초, 기본: 30~60초)\n4. 자막 언어 (선택: 한국어 / 영어, 기본: 한국어)\n\n받은 후 scripts/clip.py 실행:\n\n```bash\npython3 skills/youtube-clipper-ko/scripts/clip.py \\\n  --url \"https://youtu.be/VIDEO_ID\" \\\n  --clip-length 60 \\\n  --lang ko\n```\n\n또는 로컬 파일:\n\n```bash\npython3 skills/youtube-clipper-ko/scripts/clip.py \\\n  --file \"/path/to/video.mp4\" \\\n  --clip-length 60\n```\n\n## 출력 구조\n\n```\noutputs/YYYYMMDD_HHMMSS/\n├── source.mp4           # 원본 (URL 입력 시 다운로드)\n├── transcript.json      # Whisper 전체 자막 + 타임스탬프\n├── viral_segments.json  # 바이럴 구간 분석 결과\n├── clips/\n│   ├── clip_01_[제목].mp4\n│   ├── clip_02_[제목].mp4\n│   └── ...\n└── result.json          # 전체 메타데이터\n```\n\n## viral_segments.json 구조\n\n```json\n[\n  {\n    \"rank\": 1,\n    \"score\": 87,\n    \"start\": \"03:14\",\n    \"end\": \"04:02\",\n    \"title\": \"월 200만원 자동화하는 방법\",\n    \"reason\": \"구체적인 금액과 방법이 동시에 나옴. 첫 3초 안에 결론 제시.\",\n    \"hook\": \"근데 진짜 이게 되거든요\",\n    \"clip_file\": \"clips/clip_01_월200만원자동화.mp4\"\n  }\n]\n```\n\n## Clawitzer 연결\n\n클립 추출 후 Clawitzer 파이프라인으로 넘기려면:\n\n```bash\n# 추출된 클립을 Clawitzer 소스로 사용\npython3 projects/clawitzer/main.py \\\n  --video \"skills/youtube-clipper-ko/outputs/TIMESTAMP/clips/clip_01.mp4\" \\\n  --script-file \"skills/youtube-clipper-ko/outputs/TIMESTAMP/clip_01_script.json\"\n```\n\n단, Clawitzer의 TTS는 사용하지 않음 (원본 음성 유지).\neditor.py의 자막/편집 로직만 활용 가능.\n\n## API 키\n\n- OpenAI Whisper: TOOLS.md의 Gemini 키 대신 OpenAI API 필요 (없으면 달비님께 요청)\n- Anthropic Claude: 기존 설정 사용 (환경변수 ANTHROPIC_API_KEY)\n\n## 바이럴 구간 선정 기준 (Claude 프롬프트 기반)\n\n1. **감정 강도**: 놀람, 공감, 궁금증, 웃음 유발 구간\n2. **정보 밀도**: 구체적 숫자/금액/방법이 나오는 구간\n3. **완결성**: 클립 단독으로 이해 가능한 구간\n4. **훅 가능성**: 첫 3초 안에 시청자를 잡을 수 있는 문장 포함 여부\n5. **한국어 최적화**: 한국 시청자 반응 패턴 반영\n\n## 무음/숨소리 처리\n\nClawitzer editor.py 로직 차용:\n- silenceremove 필터 (max_gap_sec=0.06)\n- 완전 제거가 아닌 압축 (자연스러운 흐름 유지)\n- 숨소리 구간: 50ms로 압축\n\n## 자막 스타일 (Clawitzer 3색 룰)\n\n- 기본: 흰색(#FFFFFF), 52px\n- 빨강 앞뒤: 노란색(#FFFF00), 52px\n- 강조 키워드: 빨강(#FF0000), 62px (연속 불가)\n- 폰트: SUIT ExtraBold (없으면 NotoSansCJK fallback)\n- 자간: -1 (좁힘)\n- 위치: 화면 중앙 (an5, Y=900/1920)\n","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":540,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773615956382,"updatedAt":1778491933006},"latestVersion":{"version":"0.1.0","createdAt":1773615956382,"changelog":"youtube-clipper-ko v0.1.0 initial release\n\n- 자동으로 한국어 YouTube 영상을 바이럴 클립으로 분할해주는 기능 제공\n- Whisper로 음성 분석, Claude Haiku로 바이럴 구간 8~12개 선정, ffmpeg로 클립 추출\n- 무음/숨소리 구간 압축 및 3색 SUIT ExtraBold 한국어 자막 자동 추가\n- YouTube URL, 로컬 파일 입력 모두 지원\n- 클립별 바이럴 점수와 선정 이유 자동 부여, 메타데이터 JSON 포함\n- Clawitzer 파이프라인과 연동 가능","license":"MIT-0"},"metadata":null,"owner":{"handle":"thedalbee","userId":"s17fcz1aty07a6sx2gfs2yesa988440b","displayName":"thedalbee","image":"https://avatars.githubusercontent.com/u/262329684?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089907903}}