Communitygithub.com

shorts-pipeline

수직 1080x1920 숏폼 비디오(YouTube Shorts, Reels, TikTok)를 제작, 렌더링, 검사, 믹싱 및 패키징합니다. 클립 기반 파이프라인(edl.json, build.py, check.py, sound/mix.py)을 사용하며, 영상 제작, 수정, 검토, 서브 에이전트 편집자 지시 또는 check.py 실패 이유 설명에 사용합니다.

shorts-pipeline란 무엇인가요?

이 스킬은 사진 "창" 안에서 움직이는 클립, 단어 캡션, 훅 플레이트, 히어로 서클, 커버, SFX 큐 리스트, -14 LUFS 사운드 믹스로 구성된 수직 1080x1920 숏폼 비디오를 제작하는 완전한 파이프라인입니다. 프로젝트별 채널 설정(CHANNEL.md)을 먼저 읽고 기본값보다 우선 적용해야 합니다. 파이프라인은 에디트 리스트(edl.json)와 보이스오버 파일을 입력으로 받아 build.py로 렌더링하고, check.py로 자동 검증하며, sound/mix.py로 사운드를 믹싱합니다. GitHub, Sourcegraph Cody, Claude Code, Cursor, VS Code, Codex CLI 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, doctor.sh로 종속성을 확인한 후 shorts-init.sh로 프로젝트를 초기화하여 사용합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ilyamelnichenkov/youtube-shorts/tree/HEAD/skills/shorts-pipeline

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

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

문서

숏츠 파이프라인 (주제 중립적)

하나의 편집 목록(<short>/edl.json)과 보이스오버로 완성된 비디오가 만들어집니다: 테마 사진 "창" 안에서 움직이는 클립, 단어 캡션, 훅 플레이트, 히어로 서클 하나, 커버, SFX 큐 리스트, -14 LUFS 사운드 믹스. 채널 특화된 모든 것(주제, 언어, 시청자, 콘텐츠 규칙, 외관, 음성, 크레딧, 일정)은 프로젝트의 CHANNEL.md에 있습니다. 먼저 읽고 아래 기본값보다 우선 적용하세요. 파일이 없거나 섹션이 비어 있으면, 아무것도 제작하기 전에 소유자에게 문의하거나(또는 engine/templates/CHANNEL.md를 복사하여 함께 작성) 하세요. 관련 스킬: shorts-script-voice(주제, 스크립트, 음성) 및 shorts-packaging(완성된 파일, 업로드 텍스트).

시작 전에

  1. 킷 스크립트(setup.sh, shorts-init.sh, doctor.sh, install-codex.sh)는 킷의 scripts/ 폴더에 있습니다: 플러그인 폴더 또는 $SHORTS_HOME/kit/scripts/ (setup.sh와 install-codex.sh는 사본을 유지).
  2. _pipeline/, _tools/, _fonts/, CHANNEL.md를 포함하는 프로젝트 폴더에서 작업합니다(scripts/shorts-init.sh <dir>로 생성). 아래 모든 명령은 해당 폴더의 루트에서 실행됩니다.
  3. scripts/doctor.sh <project-dir>를 각 머신에서 한 번 실행합니다. 모든 종속성(시스템 프로그램, Python 패키지, 모델, 여유 디스크)을 확인하고 "All good."으로 끝나야 합니다. 그렇지 않으면: ffmpeg/Python/curl용 scripts/install-system-deps.sh, 나머지용 scripts/setup.sh. 전체 목록은 킷의 DEPENDENCIES.md에 있습니다.
  4. SHORTS_HOME(기본값 ~/.shorts-studio)은 Python 가상 환경과 음성 모델을 보관합니다. 다른 곳에 둔다면 내보내세요.
  5. 편집 목록을 작성하기 전에 _pipeline/README.md(엔진 참조)와 references/edl-notes.md를 읽으세요.

워크플로 (각 단계마다 자체 검사가 있습니다)

#단계명령 / 출력확인
1주제 + 스크립트스킬 shorts-script-voice하나의 주장, 출처 명시, 프로필이 요청하면 소유자 승인
2음성$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, 그런 다음 _tools/words.py <short>/vovo/words.json 읽기: 모든 단어가 정확한지
3푸티지_tools/grab.py <topic> '<url>' <start> <end> --tag NAME (_footage/SOURCES.md에 기록), 또는 직접 녹화모든 클립의 콘택트 시트; CHANNEL.md의 정책
4편집 목록references/edl-template.json 복사, 내용 변경build.py <edl> --words가 캡션 토큰 표시
5렌더링python3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10분; 4K60은 느림)오류 없음; 파일이 edl보다 최신
6커버... build.py <edl> --cover"안전 영역 위반: 없음", 180px 너비에서 읽기 가능
7검사python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.jsonALL CHECKS PASS 출력; 모든 콘택트 시트 확인
8사운드$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict-14.0 +/-0.5 LUFS, 트루 피크 <= -1.0 dBTP, 단어 오류 0에 가까움
9패키징스킬 shorts-packagingready/에 파일 + 커버 + 업로드 블록

소스 클립의 콘택트 시트: ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (PNG 작성: 일부 소스의 JPEG 출력이 "non full-range YUV"로 실패). 샷 경계: ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*". 테마: case-file(서류 용지), panel-heist(만화 페이지), vice-dusk(네온 황혼), classic; 프로필이 하나를 선택합니다.

좋은 숏츠의 모습 (기본값; 프로필이 재정의)

  • 18-45초, 훅에서 결말까지 하나의 주장, 1.5-3초마다 컷, 모든 샷이 움직임, 훅 플레이트는 프레임 0부터 켜짐 (hook.y 1170은 전시 레이블과 겹치지 않도록 유지), 프레임이 실제로 보여주는 것에 빨간 원이 있는 히어로 순간 하나.
  • 그림이 단어를 따릅니다. 캡션은 2-3단어 구(break_before); 이름은 하나의 그룹으로 유지.
  • 마지막 샷이 첫 번째 프레임으로 다시 컷 (비디오가 반복됨).
  • 모든 읽을 수 있는 텍스트는 전화 안전 영역 내에 유지: y 300-1580, x 130-950 (y 1000-1600의 경우 x <= 860). check.py가 강제.
  • 1080p 이상 클립에 "aspect": "3:4"(900x1200)의 높은 사진 창. 720p 또는 레터박스 소스는 채울 수 없음.

힘들게 얻은 교훈 (자세한 내용은 references/lessons.md)

  • edl이 렌더링보다 최신? 렌더링이 오래된 것입니다. check.py를 판단하기 전에 다시 빌드하세요.
  • 정지된 스틸(연속 프레임이 0.3초 이상 거의 차이 없음)은 check.py를 실패시킵니다. 정적 화면, 평평한 색상, 움직임이 없는 피사체는 일정한 속도의 움직임이 필요: "move_ease": "linear", 0.15-0.4의 줌 범위 및 150+ 소스 픽셀의 팬. float만으로는 충분하지 않음 (사인파가 방향 전환에서 0으로 느려짐).
  • 줌 제한: 4K 소스 <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py가 클립당 제한 출력).
  • 크리에이터 오버레이(워터마크, 페이스캠, 하단 1/3, 자막, 스타일 배너)는 그림에 닿지 않음: 최상위 sources 그림 오버라이드로 자르기, 자르기 이동, 또는 다른 프레임 선택. 모든 컷 프레임을 확인.
  • 정직성: 라벨, 원, 캡션은 프레임이 보여주는 것만 말함; 음성에서 사실을 출처에 귀속.
  • 커버: 하나의 소스 프레임을 전체 면적으로 자름; 플레이트는 tab_y(330)에 위치하여 그림 상단을 가림. 상단에 가까운 피사체의 경우 tab_y를 약 1090, stamp_y를 약 410으로 설정.
  • 한 번에 하나의 렌더링 (4K60 렌더링은 모든 코어 사용); 같은 폴더의 두 번째 렌더링을 시작하지 마세요.

서브 에이전트에게 편집 위임

에이전트에게 BRIEF.md(shorts-init이 references/editor-brief.md에서 생성)와 스크립트, 음성 파일, 클립 목록을 제공하세요. 메인 세션은 스크립트와 음성을 작성하고, 모든 프레임을 직접 검토하며 사운드 믹스를 수행합니다: 에이전트의 보고는 주장일 뿐 증거가 아닙니다. 수락하기 전에 파일 시간(무음 mp4가 edl보다 최신, 검사 로그가 mp4보다 최신)을 확인하세요.

Individual skills in this repo

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

관련 스킬