Communitygithub.com

카운트다운 비디오

순위가 매겨진 목록을 영화/리스트 채널 스타일의 애니메이션 카드가 포함된 완성된 리스트 비디오로 변환합니다. 순위 공개/연도별 진화, 선택적 예고편 클립, 음악, 효과음 및 YouTube 챕터를 지원하고 MP4로 렌더링합니다.

카운트다운 비디오란 무엇인가요?

이 스킬은 순위가 매겨진 데이터(예: 영화, 박스오피스, 평점 또는 모든 순위 목록)를 가져와 '카운트다운'(No.1부터 시작하여 내려감) 또는 '타임라인'(연도별 진화) 모드의 전문적인 애니메이션 비디오로 바꿉니다. 각 항목은 사용자 정의 가능한 통계, 평점 및 흥미로운 사실이 포함된 애니메이션 카드를 표시하며, 선택적으로 전체 화면 예고편 클립이 뒤따릅니다. 이 엔진은 반응형 HTML 템플릿을 사용하여 카드, 인트로, 아웃트로 및 진행 상황 추적기를 생성한 다음, Playwright 및 ffmpeg를 사용하여 최종 MP4 파일로 렌더링합니다. 각 항목과 예고편 클립에 대한 YouTube 챕터를 자동으로 생성하여 콘텐츠 제작자의 업로드 프로세스를 간소화합니다. 사용자는 `items.json` 파일에서 모든 데이터(순위, 제목, 연도, 통계, 평점, 예고편 파일, 소스)를 제공하며, 엔진은 CSS 테마를 통해 오렌지/그린/옐로우 카드와 같은 시각적 스타일을 완벽하게 제어합니다. 배경 음악, 효과음 큐(후이시, 히트, 팝, 틱) 및 선택적 음성 해설을 지원하며, 360p에서도 가독성을 보장합니다. 이 스킬은 연구에 엄격함을 적용합니다. 모든 숫자는 검증된 소스에서 가져와야 하며, 사용자가 이미지나 예고편을 직접 제공하도록 요구하여 저작권 문제를 피합니다. 최종 결과물은 MP4 파일, 챕터 목록, 소스 링크 및 YouTube 설명, 태그, 종료 화면 요소에 대한 제안 사항입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/countdown-video-skill/tree/HEAD/skills/countdown-video

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

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

문서

카운트다운 비디오은(는) 무엇을 하나요?

순위가 매겨진 목록을 영화/리스트 채널 스타일의 완성된 리스트 비디오로 변환합니다. 두 가지 모드:

  • "mode": "countdown" (기본값): No.N → No.1, 각 항목 앞에 주황색 "No.X" 슬램이 나타납니다.
  • "mode": "timeline": "진화" 비디오 (예: LAIKA 애니메이션 진화 2005–2022), 오래된 것부터 최신 순서로, 각 항목 앞에 큰 연도 카드가 나타납니다.

두 모드 모두 항목은 예고편 클립을 가질 수 있으며, 카드 직후 전체 화면으로 재생되고, 하단 1/3 타이틀과 예고편 자체 사운드가 포함됩니다(음악은 그 아래로 작아집니다). 리스트 채널에서 카드 + 영화당 약 25~30초 예고편은 시청자를 가장 오래 붙잡는 형식입니다.

비디오는 인트로, 각 항목에 대한 "No.X" 순위 슬램, 이어서 애니메이션 카드(이미지, 제목, 연도, 장르, 막대 그래프가 포함된 통계, 평점, 흥미로운 사실), 진행 상황 추적기, YouTube 종료 화면 요소를 위한 슬롯이 있는 아웃트로로 구성됩니다. 모든 것은 데이터 기반입니다: 연구 내용은 items.json에 저장되고, 엔진이 렌더링합니다.

사용자가 선호하는 언어로 대화하세요. 코드와 items.json은 사용자가 화면 텍스트를 다른 언어로 원하지 않는 한 영어로 유지하세요.

파일 (이 스킬 폴더 기준)

파일목적
templates/countdown_template.html엔진: 인트로, 순위 카드, 항목 카드, 트래커, 아웃트로. 테마 및 타이밍은 items.json에서 재정의 가능합니다.
scripts/build_countdown.pyitems.json → _work/build.html, timeline.json, cues.json (SFX), chapters.txt; 누락되었거나 읽을 수 없는 이미지를 플래그합니다.
scripts/render.py결정적 프레임 범위 렌더러 (Playwright → x264).
scripts/compose_clips.py각 항목의 예고편 클립을 전체 프레임(레터박스)에 하단 1/3 "예고편 · 제목 (연도)"와 함께 배치하고 클립 오디오를 추출합니다. make_countdown.sh에 의해 자동 실행됩니다.
scripts/countdown_audio.py원래 업비트 음악 루프 (또는 --music your_track.mp3), 큐에 따른 후이시/히트/팝/틱 SFX, 예고편 오디오와 음악이 --clip-music (기본값 0.12)로 낮춰짐, 선택적 순위 음성.
scripts/make_countdown.sh전체 파이프라인: 빌드 → 병렬 렌더 → 오디오 → MP4 + QA 시트 + 챕터.

설정: pip install playwright soundfile scipy pillow --break-system-packages 및 playwright install chromium (없는 경우); PATH에 ffmpeg. 선택적 음성: Kokoro TTS (PPT 애니메이션 스킬의 voiceover.py 참조).

워크플로우

  1. 브리핑. 주제, 모드 (카운트다운 또는 타임라인), 항목 수 (N), 순위 측정 지표 (예: 전세계 박스오피스), 표시할 필드, 예고편 클립 포함 여부 (및 길이, 기본값 25초), 비디오 길이 (≈ 5초 인트로 + N × (~11초 + 클립) + 12초 아웃트로), 음악 (사용자 트랙 또는 생성). 사용자가 있으면 한 번 묻고; 그렇지 않으면 합리적인 기본값을 선택하고 말하세요.
  2. 순위 연구. 웹 검색을 사용하고 소스 페이지를 열어보세요. 절대 기억에서 숫자를 채우지 마세요. 선호하는 소스: Box Office Mojo / The Numbers (예산, 전세계 총수익), IMDb, Rotten Tomatoes, Metacritic (평점), 연도 및 장르용 Wikipedia. 각 항목의 sources에 URL을 기록하세요. 두 소스가 일치하지 않으면 순위 측정 지표에 대해 하나의 소스를 일관되게 사용하고 메모하세요. 값을 찾을 수 없으면 해당 필드를 생략하세요 (카드가 적응함) — 절대 만들어내지 마세요.
  3. items.json 작성 (아래 스키마), 순위 1..N (1이 최상위 항목). 비디오는 N → 1로 카운트다운합니다 ("order": "up"은 순서를 반전).
  4. 이미지 및 클립. 사용자가 제공한 이미지 및 예고편 파일 사용 (posters/<slug>.jpg, 2:3 세로; clips/<slug>.mp4). 직접 포스터, 예고편, 스틸컷 또는 사람 사진을 웹에서 다운로드하지 마세요. 사용자에게 폴더에 넣도록 요청하세요. 이미지가 없으면 카드는 깔끔한 제목 플레이스홀더를 표시하고, 클립이 없으면 건너뛰므로 초안을 먼저 렌더링할 수 있습니다. 각 클립에 대해 start (스튜디오 로고 및 검은 프레임 건너뛰기) 및 duration을 선택하세요. 예고편은 YouTube에서 Content ID 클레임을 유발할 수 있습니다. 이는 채널 소유자의 결정이므로 한 번 언급하세요.
  5. 빌드 + 미리보기. python3 scripts/build_countdown.py items.json _work/ 실행 후 몇 가지 순간 (인트로 ~3초, 순위 카드, 전체 항목 카드 끝, 아웃트로)을 스크린샷하고 확인: 겹치는 것 없음, 긴 제목이 잘 맞음, 360p에서 숫자가 읽힘.
  6. 렌더링. bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir].
  7. QA. out_sheet.png를 열고; items.json의 숫자와 대조 확인; 지속 시간을 확인하고 모든 순위가 한 번씩 나타나는지 확인.
  8. 전달. MP4, 챕터 (out_chapters.txt, YouTube 설명에 붙여넣기), 소스 목록, 제안된 제목/설명/태그. 사용자에게 YouTube Studio에서 아웃트로 슬롯 위에 종료 화면 요소를 추가하도록 상기시키세요.

items.json 스키마

아래 값은 형태를 보여주는 자리 표시자일 뿐, 실제 데이터가 아닙니다.

{
  "title": "최고 수익 스톱모션 영화 Top 5",
  "subtitle": "전세계 박스오피스 순위",
  "channel": "채널 이름",
  "currency": "$",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "당신이 가장 좋아하는 것은?",
  "outro_subtitle": "댓글로 알려주세요!",
  "timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
  "theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
  "items": [
    {
      "rank": 1, "title": "치킨 런", "year": 2000, "subtitle": "가족/코미디",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "예산", "value": 45000000}, {"label": "박스오피스", "value": 225100000}],
      "multiple": "예산의 5배",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "짧고 출처가 있는 한 문장.",
      "teaser": "No.X 슬램 아래에 표시할 선택적 줄",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "슬램 카드에 No.X 대신 표시할 선택적 텍스트 / 연도",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value가 숫자이면 → 애니메이션 숫자 올리기 + 비교 막대 (막대는 카드당 하나의 공통 스케일 공유); 문자열이면 → 그대로 표시 (예: "N/A", "8,848m"). 모든 라벨이 작동하므로 동일한 엔진이 비영화 카운트다운(가장 높은 건물, 가장 부유한 사람, 가장 빠른 자동차)에도 적합합니다.
  • ratings 키는 선택 사항: imdb (0–10, 별), rt / rt_audience / metacritic (0–100, 링). 누락된 키는 사라집니다. 평점이 없는 카드는 다른 상자를 중앙에 배치합니다.
  • clip.start는 초 또는 m:ss 형식을 허용합니다. 클립은 16:9로 레터박스 처리되어 카드 후에 재생됩니다. 챕터와 종료 화면 타이밍은 클립 길이를 자동으로 반영합니다.
  • intro_image (예: 사용자가 제공한 스튜디오 로고)는 인트로의 TOP N / EVOLUTION 배지를 대체합니다.
  • 타임라인 모드에서는 항목이 year별로 정렬됩니다. 카드의 순위 배지는 숨겨지고 챕터는 "제목 (연도)"로 읽힙니다.
  • multiple은 통계 상자 아래의 짧은 하이라이트 알약입니다. 출처가 있는 숫자에서 계산하세요 (소수점 첫째 자리까지 반올림).
  • 평점은 텍스트 라벨로만 표시됩니다 — 브랜드 로고 없음.
  • 화면에 표시되는 모든 평점, 숫자 또는 사실은 sources의 출처에서 가져와야 합니다.

스타일 참고 사항

  • 기본 테마는 클래식 리스트 채널과 일치합니다: 교차하는 녹색/노란색 크레용 질감 카드, 빨간색 테두리, 광선이 있는 주황색 "No.X" 슬램, 보라색 통계 상자, 파란색 평점 상자. theme에서 모든 색상을 재정의할 수 있습니다.
  • 360p에서 가독성: 제목을 짧게 유지 (부제가 장르를 전달함), 사실은 2줄 이하로 유지, 통계는 4개 이상 추가하지 마세요.
  • 유지율: 항목당 ~11초; 가장 강력한 항목을 마지막에 배치; 순위 슬램 + 후이시/히트 SFX는 각 항목마다 주의를 재설정합니다. 인트로는 5초 이하로 유지.
  • YouTube 챕터는 각각 최소 10초가 필요하므로 인트로는 첫 번째 순위의 챕터에 자동으로 포함됩니다.

관련 스킬