Community라이팅 & 에디팅github.com

youtube-packaging

완성된 유튜브 영상, 스크립트 또는 대본을 업로드 패키지로 변환합니다. 모든 항목이 코드로 검증됩니다. 3개의 제목 옵션, 유튜브가 인식하는 챕터(0:00부터 시작, 3개 이상, 각각 10초 이상)가 포함된 설명, 질문을 던지는 고정 댓글, 깔끔한 줄 길이의 SRT 자막 파일, 그리고 3개의 완성된 썸네일(비디오 자체 프레임에서 추출한 1280x720 PNG, 6가지 레이아웃, 명암비와 휴대폰 크기 가독성 확인, 유튜브 '테스트 및 비교'용)을 생성합니다.

youtube-packaging란 무엇인가요?

이 스킬은 완성된 유튜브 영상의 스크립트나 대본을 업로드에 필요한 모든 요소로 변환하는 전문 기술입니다. 제공되는 Python 스크립트(`check_package.py`, `make_srt.py`, `thumbs.py`)를 사용하여 제목 3개, 챕터가 포함된 설명, 고정 댓글, SRT 자막 파일, 썸네일 3개를 생성하고 코드로 검증합니다. 장르나 길이에 관계없이 사용할 수 있으며, 특히 긴 형식의 영상에 최적화되어 있습니다. 사용자는 완성된 영상, 스크립트, 대본 또는 단어별 타임스탬프가 있는 전사본만 제공하면 되며, 각 스킬 단계(입력 수집, 영상 분석, 챕터 생성, 제목 및 썸네일 제작, 설명 작성, 패키지 검증)를 따라 일관되고 최적화된 업로드 패키지를 얻을 수 있습니다.

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

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

YouTube 패키징

완성된 영상의 스크립트나 대본을 업로드에 필요한 모든 것으로 변환합니다: 제목, 챕터가 포함된 설명, 고정 댓글, 자막, 썸네일 3개. 모든 분야, 모든 길이(긴 형식에 맞춰 제작되었으며, 짧은 영상에도 작동합니다).

스크립트는 이 SKILL.md 옆에 있는 scripts/ 폴더에 있습니다. python(3.10 이상)을 사용하여 해당 폴더의 절대 경로로 실행하세요. check_package.py와 make_srt.py는 다른 것이 필요 없습니다. 썸네일(thumbs.py)은 Pillow, numpy, Playwright(Chromium 포함)가 필요하며(python -m pip install pillow numpy playwright 그 다음 python -m playwright install chromium), 영상 파일에서 프레임을 가져올 때는 ffmpeg도 필요합니다.

1. 입력 수집

  • 영상의 내용, 가장 좋은 순서: 단어별 타임스탬프가 있는 JSON(단어별 타임스탬프를 제공하는 전사 도구에서), 타임스탬프가 있는 대본(0:12 text 줄, 복사한 YouTube 대본, SRT 또는 VTT), 또는 스크립트만 있는 경우(그러면 모든 시간은 추정치이며, 그렇게 명시하세요).
  • 영상의 최종 길이(마지막 챕터와 자막용).
  • 영상이 약속하는 리소스 또는 링크(있는 경우). 실제 링크가 없으면 사용자가 채울 수 있도록 [LINK]라고 쓰세요.
  • 선택 사항: 이전 채널 설명(새 설명이 반복되지 않도록), 작업 제목이나 썸네일 아이디어, 시청자.

2. 먼저 영상 읽기

전체 스크립트 또는 대본을 읽고 다음을 기록하세요: 처음 30초 안에 한 약속, 주요 보상, 섹션과 각 섹션의 시작 지점, 영상에 나오는 구체적인 숫자, 가장 놀라운 순간. 모든 제목, 썸네일 텍스트 및 설명 줄은 영상이 실제로 제공하는 내용과 일치해야 합니다.

3. 챕터

  • 섹션당 하나의 챕터; 챕터 시간은 해당 섹션의 첫 번째 음성 단어 시간입니다. 단어별 타임스탬프 또는 타임스탬프가 있는 대본이 있는 경우 각 섹션의 첫 번째 단어를 찾으세요. 스크립트만 있는 경우에는 추정(섹션 전 단어 수 / 분당 단어 수)하고 편집 후 수정할 추정 시간임을 표시하세요.
  • YouTube 규칙: 목록은 0:00에서 시작합니다(후크는 해당 챕터에 속함), 3개 이상의 챕터를 포함하며, 10초보다 짧은 챕터는 없어야 하고, 시간 순서대로이며, 1시간 이후의 시간은 1:05:00으로 표기합니다. 10초 미만인 챕터는 이웃 챕터에 병합됩니다.
  • 챕터 제목은 해당 섹션이 다루는 내용이나 묻는 것을 말하며, 결론을 말하지 않습니다("물주기 실수", "매일 물주지 마세요" 대신); 2~6단어; em 대시 없음.

4. 제목 (3개 옵션)

  • 각 옵션은 다른 각도를 취합니다: 결과, 문제 또는 실수, 호기심 차이 또는 대조. 시청자가 검색할 단어를 앞부분에 배치하세요.
  • 최대 60자(YouTube는 100자를 허용하지만, 긴 제목은 휴대폰과 검색에서 잘립니다).
  • 영상의 첫 30초는 제목의 약속을 확인해야 합니다. 오프닝이 뒷받침하지 않는 제목은 처음 몇 초 안에 시청자를 잃습니다.
  • 숫자는 영상이 말할 때만 사용하세요. 해시태그, 링크, 과장된 단어, 또는 두 단어 이상의 대문자 사용은 금지합니다.

5. 썸네일 (완성된 이미지 3개)

  • 텍스트: 최대 5단어, 휴대폰 크기에서 읽을 수 있어야 합니다. 썸네일은 제목을 반복하는 대신 보완합니다: 함께 이야기를 전달합니다(제목: 약속; 썸네일: 이해관계, 결과, 반전). 숫자는 영상에서만 가져옵니다.
  • 사진: python <skill-folder>/scripts/thumbs.py frames VIDEO_OR_IMAGE_FOLDER work/ 가장 선명하고 가장 다른 프레임을 work/frames/f01.png ...로 유지합니다. work/frames.jpg를 열고 보상을 보여주는 프레임을 선택하세요(반응하는 얼굴, 결과, 전후). 영상이 없습니까? 사용자 자신의 사진이나 폴더의 스크린샷을 사용하세요. 절대 타인의 사진을 사용하지 마세요.
  • work/thumbs.json 작성: 한 가지(텍스트, 사진 또는 레이아웃)에서만 다른 세 가지 변형을 작성하여 YouTube의 '테스트 및 비교'에서 어떤 것이 효과적인지 알 수 있게 합니다. 6가지 레이아웃: simple, shock(확대 및 링), big-number, header, comparison(두 사진), blur(공개). 형식, 레이아웃 및 옵션(초점, 강조 단어, 텍스트 위치, 브랜드 색상): references/thumbnails.md.
  • 렌더링: python <skill-folder>/scripts/thumbs.py render work/thumbs.json out/ [--brand brand.json]. out/thumb-a.png 등과 out/thumbs.jpg를 작성합니다: 각 변형을 크게, YouTube 홈 타일과 제목과 함께, 휴대폰 크기로, 그리고 검사 결과와 함께(1280x720, 2MB 미만, 최대 5단어, 글자 높이 최소 54px, 휴대폰 크기에서도 읽을 수 있음, 텍스트가 프레임 안에 있음, 배경과의 명암비 4.5:1). thumbs.jpg를 열고, 모든 실패를 수정하고(더 짧은 텍스트, "shade": 0.65, 다른 레이아웃 또는 사진) 다시 렌더링하세요.

6. 설명

다음 순서로:

  1. 오프닝: 각각 최대 160자인 2줄로, "...더보기" 앞에 표시됩니다. 아직 클릭할지 결정 중인 사람을 위해 새로운 단어로 약속을 다시 말합니다: 제목을 반복하지 않고, 링크도 없습니다.
  2. 요약: 시청자가 얻는 것에 대한 짧은 문단 하나(최대 900자). 평범한 문장, 목록 없음.
  3. 리소스 줄(영상이 약속하는 경우에만): 무엇인지, 그 다음 링크 또는 [LINK].
  4. 챕터: 한 줄에 하나씩, 0:00 제목.
  5. 선택 사항: 크리에이터가 항상 추가하는 크레딧 또는 링크.

모든 내용을 합쳐 최대 5,000자. 기본적으로 해시태그 없음(주제는 태그에 입력), 과장된 단어 없음, em 대시 없음, 그리고 이전 설명과 3단어 실행의 30% 이상을 공유하지 않음.

7. 고정 댓글 및 태그

  • 고정 댓글: 영상의 핵심 문제 또는 시청자의 다음 단계에 연결된 질문 하나, 한 단어나 한 줄로 답변하기 쉬운 것. 최대 200자, 링크 없음.
  • 태그(선택 사항): 3개 이상, 모두 합쳐 최대 500자, # 없음, 태그 내에 쉼표 없음.

8. 자막

python <skill-folder>/scripts/make_srt.py words.json -o video.srt                   # 단어별 타임스탬프
python <skill-folder>/scripts/make_srt.py transcript.txt --end 18:42 -o video.srt   # 타임스탬프 줄
python <skill-folder>/scripts/make_srt.py --validate video.srt                       # 기존 파일 확인

큐: 최대 42자 2줄, 화면에 1~7초 표시, 먼저 문장 끝에서 자르고, 그 다음 쉼표에서 자름; 숫자는 단위와 함께 유지하고 이름은 절대 분할하지 않음; 겹치지 않음, 큐 사이에 최소 80ms 간격. 모두 조정 가능(--max-chars, --max-lines, --min-dur, --max-dur, --gap-ms). 보고서는 stderr로 전송됩니다. 종료 코드 0은 파일이 깨끗하다는 의미입니다. 구두점이 없는 타임스탬프 줄(원시 자동 자막)은 길이와 일시 중지만으로 자릅니다: 더 나은 큐를 위해 먼저 대본에 구두점을 추가하세요.

9. 패키지 확인

이 Markdown 형식으로 패키지를 작성하세요(동일한 키를 가진 JSON도 작동함: titles, description, pinned_comment, thumbnail_texts, tags, duration):

---
duration: 18:42
---

## 제목
1. ...
2. ...
3. ...

## 설명
```
오프닝 줄 1.
오프닝 줄 2.

요약 문단.

0:00 첫 번째 챕터
...
```

## 고정 댓글
...?

## 썸네일 텍스트
1. ...
2. ...
3. ...

## 태그
태그1, 태그2, 태그3

그 다음 실행:

python <skill-folder>/scripts/check_package.py package.md --srt video.srt --source transcript.txt
python <skill-folder>/scripts/check_package.py package.md --duration 18:42 --earlier old-desc-1.txt old-desc-2.txt
  • --duration(또는 파일 내 duration:)은 마지막 챕터를 확인합니다. 없으면 마지막 자막의 끝이 사용됩니다. --source는 제목이나 썸네일 텍스트의 모든 숫자가 영상에 나타나는지, 그리고 오프닝이 각 제목과 단어를 공유하는지 확인합니다. --earlier는 반복된 설명을 차단합니다.
  • FAIL은 반드시 수정해야 합니다. WARN은 수정하거나 설명해야 합니다. 종료 코드 0은 실패한 것이 없음을 의미합니다(--strict는 경고에서도 실패하며, --json은 기계 판독 가능한 결과를 출력합니다).
  • 제한 및 과장된 단어 목록은 scripts/package-rules.json에 있습니다. 복사하고, 키를 유지한 채 변경한 후 --rules my-rules.json으로 전달하세요(예: "allow_hashtags": true, "title_max": 70).

모든 실패를 수정하고, 다시 실행한 후 결과를 반환하세요.

10. 반환

  1. package.md: 세 가지 제목(자신의 선택과 그 이유를 한 줄로 표시), 붙여넣기 준비된 설명, 고정 댓글, 세 가지 썸네일 텍스트, 태그.
  2. .srt 파일과 세 개의 썸네일 PNG(out/thumb-a.png, -b, -c), 그리고 out/thumbs.jpg.
  3. 업로드 단계: 설명 붙여넣기(YouTube는 시간 줄에서 챕터를 생성함), 영상 언어의 자막으로 SRT 업로드, 세 개의 썸네일을 '테스트 및 비교'에 추가, [LINK]를 실제 링크로 대체, 게시 후 댓글 고정, 마지막 20초는 엔드 스크린을 위해 비워 둠.
  4. 검사기 결과 줄, 그리고 수락된 경고와 그 이유.

모든 규칙과 그 존재 이유에 대한 자세한 내용: references/packaging-rules.md.

작동 예시

examples/transcript.txt는 작은 발코니에서 음식을 재배하는 10:06 길이 영상의 타임스탬프가 있는 대본입니다. examples/words.json은 처음 46초에 대한 단어별 타임스탬프를 포함합니다.

python scripts/make_srt.py examples/transcript.txt --end 10:06 -o test-out.srt
python scripts/check_package.py examples/package.md --srt test-out.srt --source examples/transcript.txt

첫 번째는 made 149 cues from 1497 words, 0:00.4 to 10:03.0 및 srt: ok를 출력합니다. 두 번째는 Result: 0 failed, 0 warnings, 11 passed로 끝납니다. 해당 예시의 제목은 세 가지 각도를 취합니다(결과: "Grow Real Food on a Tiny Balcony (Even If Plants Hate You)"; 방법: "The One-Day Sun Test That Decides What Your Balcony Grows"; 문제: "Why Balcony Plants Die, and the Bucket Trick That Fixes It"), 그리고 썸네일 텍스트("6 HOURS OR NOTHING", "IT WATERS ITSELF", "STOP KILLING PLANTS")는 각각 제목이 말하지 않는 것을 추가합니다. examples/package-weak.json은 실패 사례를 보여줍니다: 해시태그가 있는 긴 제목, 0:05에서 시작하는 챕터, 6초 챕터, 링크와 질문이 없는 고정 댓글, 8단어 썸네일(9개 실패).

관련 스킬