Communitygithub.com

create-short-video

세로형(9:16) 태국어 설명 동영상(Reels, Shorts, TikTok) 제작 시 사용합니다. 손그림 스타일, 소유자 녹음 음성, Remotion으로 렌더링합니다.

create-short-video란 무엇인가요?

이 스킬은 Remotion을 기반으로 60~90초 분량의 세로형(9:16) 태국어 설명 동영상을 제작하는 전체 워크플로를 제공합니다. 주요 용도는 뉴스, 도구/리포지토리 리뷰, 개념 설명, 사용 방법, 데모 등이며, 내용에 따라 뉴스, 도구 리뷰/데모, 개념, 하우투의 네 가지 스토리 형태 중 하나를 선택합니다. 가장 중요한 특징은 소유자가 직접 음성을 녹음한다는 점이며, 스크립트 작성, 녹음 파일 처리, 스토리보드 승인, 렌더링 등 각 단계별로 상세한 승인 게이트가 있습니다. 특히 태국어 텍스트 처리(예: OCR 오류 시각화)와 음성 레벨 매칭, 안전 영역 검증 등 기술적으로 까다로운 부분을 자동화합니다. 플랫폼 호환성 측면에서 bun, ffmpeg, python3 등의 도구를 필요로 하며, 태국어 교정을 위해 kien-thai/kode-thai 스킬을 함께 사용할 것을 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/savepong/skills/tree/HEAD/skills/create-short-video

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

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

문서

설명 동영상 (9:16, ~60-90초, 태국어 음성, 모든 주제)

세로형 설명 동영상 제작을 위한 런북: 뉴스, 도구 또는 리포지토리 리뷰, 개념 설명, 사용 방법, 또는 소유자가 만든 것의 데모. 제작 메커니즘과 스타일 포팅은 create-video 스킬에 있으며, 4단계 전에 로드하세요. 음성 엔진과 각각의 특성: references/voice-options.md.

필요 사항: bun, ffmpeg/ffprobe, python3, measure_ink.py를 위한 Pillow + numpy (uv run --with pillow --with numpy ...). 태국어 산문 교정은 kien-thai와 kode-thai 스킬을 사용합니다 (npx skills add chakrit/kien-thai).

기본값 (다시 물어볼 필요 없음)

  • 9:16, 1080x1920, 8-10 비트, 약 60초 (Shorts는 최대 3분 허용; 자체 녹음 스크립트는 보통 80-90초)
  • 스타일: 소유자가 마지막으로 승인한 Atlas 스타일. 템플릿 내 키트: 볼펜 (src/style/ballpoint.js, window.BP)과 화이트보드 (src/style/whiteboard.js, window.WB). 새 스타일은 붙여넣은 Futurepedia AI Style Atlas 프롬프트가 필요합니다.
  • 시각 자료는 코드로 그립니다. 실제 로고는 주제와 출처 표시에만 사용합니다. 뉴스 사진은 사용하지 않습니다. 예외: 주제가 라이브 웹 데모인 경우, 직접 캡처한 실제 브라우저 스크린샷을 "작동 모습" 비트에 혼합하고 메커니즘은 그린 비트로 설명합니다.
  • 음성: 소유자가 직접 녹음합니다. read-script.md를 전달하면 녹음 파일을 제공하며, scripts/split_recording.py 또는 scripts/assemble_takes.py가 비트로 분할합니다. 합성 음성은 소유자가 요청한 경우에만 사용합니다 (references/voice-options.md).
  • 이모지 사용 금지, API 키 사용 금지, 출처를 명시하세요.

먼저 스토리 형태를 선택하세요

형태와 비트 템플릿: templates/story-shapes.md.

형태용도라이브 재확인
뉴스어떤 일이 발생했거나 발생 중인 경우예, 렌더링 전
도구 리뷰 / 데모리포지토리, 앱 또는 제품: 기능과 핵심 요점직접 실행
개념어떤 것이 작동하는 방식아니요
하우투무언가를 수행하는 단계아니요, 단계 테스트는 필요

단계 및 승인 게이트

  1. 주제 선정. 누가 무엇을 했는지에 초점을 맞춘 뉴스보다는 설명할 메커니즘이 있는 스토리를 선호합니다. 스캔들/가십과 설명할 내용이 없는 신규 소송은 건너뜁니다. 3-4개의 순위별 선택지를 이유와 함께 제시하고, 아직 확인되지 않은 헤드라인임을 명시하세요. 먼저 date를 확인하세요.
    • 신선도: 이벤트 발생 후 약 1-2일 이내에 배송할 수 없는 뉴스 클립은 유효기간이 지난 것입니다. 그렇다면 투자하기 전에 알리세요. 대안 제시: 주요 후속 보도(예: 사후 보고서)를 기다리거나, 해당 사건을 예시로 사용하여 상시적인 개념 클립으로 재구성.
  2. 리서치. 1차 출처(리포지토리, 문서, 상태 페이지, 공식 게시물)와 여러 매체를 읽습니다. 세 가지 레이블을 구분하여 유지하세요: 본인이 확인함 / 출처가 주장함 / 본인의 해석.
    • 핸드오프 이슈/브리프: 모든 "현재 상태" 주장을 실제 상태와 비교하여 확인하세요 (PR이 병합되었는가, URL이 작동하는가, 파일이 해당 경로에 있는가). 소유자의 로컬 리포지토리를 풀하거나 체크아웃하는 대신 GitHub에서 파일을 읽습니다 (gh api repos/O/R/contents/PATH -H 'Accept: application/vnd.github.raw').
    • 데모: 브라우저에서 실제로 실행하고, 명시된 모든 수치를 재현하며, 소스에 하드코딩된 추정치를 신뢰하지 말고 자산 크기를 측정합니다 (curl -sIL ... content-length). 불일치 사항은 주장/실제 표로 보고하세요.
    • "서버 없음" / 프라이버시 주장: 페이지의 네트워크 요청을 나열합니다 (performance.getEntriesByType('resource')). 호스팅 분석 비콘(예: Cloudflare /cdn-cgi/rum)은 DevTools 스크린샷에 나타납니다. fetch 요청으로 필터링하거나 화면에 설명하세요.
  3. 스크립트 형태 템플릿을 따르며, 숫자는 글로 표기하고, 분량은 단어를 줄여서 맞추고 절대 속도를 높이지 마세요. read-script.md를 작성합니다 (번호가 매겨진 비트, 각 비트는 한 호흡).
    • 뉴스 = 역피라미드: 비트 1은 완전한 리드(누가, 무엇을, 언제)로 독립적으로 서 있어야 합니다. 그 다음으로 중요도 순서; 모든 주장에 출처를 명시 ("X ระบุว่า", "ด้าน ... เชื่อว่า"); 음성에 의견이나 도덕적 판단을 넣지 말고, 핵심 내용은 캡션에 넣으세요.
    • 크레딧과 브리프에 필요한 URL은 마지막 비트와 화면에 표시합니다.
    • kode-thai 루프를 통해 kien-thai로 교정: 감사, 규칙 슬러그 인용, 수정, 다시 읽기, 한 번의 패스에서 아무것도 발견되지 않을 때까지 반복합니다. 소유자의 구술 설명 = 개인 블로그 어조, 남성: ผม, ครับ는 인사말에만, คุณ은 시청자, เรา는 팀을 지칭합니다. 모델 초안에서 반복되는 수정 사항: เรา가 제작자와 시청자 사이를 표류 (deixis-continuity), "드롭"을 의미하는 ทิ้ง (verb-calque), ต่างหาก 없이 매달린 "ไม่ใช่ X เป็น Y" (f4/targhak-closure), เมกะ/เมกะไบ트 혼용 (용어당 하나의 형태), 인접 비트에서 ก็เลย/พอ 반복.
  4. 음성 -> 게이트 1 (소유자 청취). 녹음 지침 (QuickTime > 파일 > 새 오디오 녹음, 품질 최대, AirPods 사용 금지; 또는 iPhone 음성 메모 + AirDrop): 비트 사이에 약 2초 일시 정지, 숨 쉬는 것보다 확실히 길게 (자체 녹음된 간격은 0.6-0.9초로 문장 중간 숨과 같았으므로 임계값으로 정확히 N개로 분할 불가); 실수한 비트는 즉시 다시 읽기; 영어 이름은 자연스럽게 발음. 먼저 비트 1의 10초 테스트를 확인해보겠다고 제안하세요.
    • 녹음 파일 찾기: 소유자가 여러 파일(테이크)을 하위 폴더에 넣고 "다 됐어"라고만 말할 수 있습니다. 프로젝트 폴더를 재귀적으로 검색하고 find ~ -mmin -30 -iname '*.m4a'를 실행한 다음, 파일별로 지속 시간, volumedetect 평균/최대값 및 무음 맵을 보고한 후 절단하세요. 루프에서 경로를 따옴표로 묶으세요 (음성 메모 이름에 공백 포함).
    • 단일 파일: python3 split_recording.py <file>; 정확히 N개의 비트를 찾지 못하면 중단됩니다. 올바른 개수를 제공하는 임계값이 없으면 강제로 자르지 마세요: 대략적인 비트 시작 시간을 묻고 각 절단을 가장 가까운 무음에 맞추세요.
    • 여러 파일 / 재녹음: 어떤 파일이 어떤 비트인지 물은 다음, 비트당 {file, start, end}의 takes.json과 함께 assemble_takes.py를 실행하세요. 여러 비트가 포함된 파일은 가장 긴 무음 지점에서 분할하고, 각 절단을 단일 비트 파일의 말하기 속도(약 11 태국어 문자/초)와 비교하여 검증하세요. 음성 시간이 20% 이상 짧은 비트(단어 누락 가능성)를 플래그합니다. 모든 비트의 레벨을 맞추고 (beat_lufs), 각 일시 정지의 중간을 잘라내어 문장 중간 일시 정지를 max_pause로 단축시킨 다음 (ffmpeg silenceremove는 이 작업을 거의 수행하지 못함), loudnorm 전에 압축합니다 (음성 crest ~22 dB; TP -1.5에서 약 -18 LUFS에 도달).
  5. 스토리보드 -> 게이트 2 (소유자 승인). 각 비트 종료 시점의 스틸 이미지를 연락처 시트와 풀 해상도 PNG로 제공합니다. 가정했거나 설명을 위해 추가한 모든 것을 나열하세요.
    • 픽셀 단위로 프레이밍을 측정하고, 절대 눈대중으로 하지 마세요 (눈대중으로 한 번 균일한 오른쪽 시프트를 놓친 적이 있습니다). scripts/measure_ink.py --z .. --camx .. --camdy .. stills...는 각 비트의 잉크를 TikTok/Reels 안전 상자 x 140-940, y 230-1500 내에 맞추고 (그렇지 않으면 콘텐츠가 앱 UI 아래로 넘침) 수정된 CAMXS/CAMDY/ZS를 출력합니다. 한 번의 재측정 패스로 >= 8px 여백을 확보합니다. 안전하지 않은 밴드를 색상으로 표시한 storyboard-sheet-safezone.png를 제공하세요 (ffmpeg drawbox).
    • 각 스틸은 해당 비트의 마지막 마크 직후(IO 종료)에 촬영하고, 다음 비트 시작에서 상수를 뺀 시점이 아닙니다. 일찍 끝나는 비트는 이미 스크롤되어 사라지고 있으며 측정이 크게 어긋납니다.
    • OCR / 텍스트 인식 오류 표시: 루프가 없는 태국어 글꼴 (Sriracha, Mali, 대부분의 UI 글꼴)은 น을 라틴어 u로, บ/ป를 U로 그리므로 Qนotation과 같은 잘못된 읽기가 화면과 시각 검사에서 올바르게 보입니다. JS 텍스트를 통해 문자열을 확인하고, 스크린샷으로 확인하지 마세요. 잘못된 읽기는 Itim(루프형, OFL, 템플릿에 번들)으로 그리고 measureText를 사용하여 뒤집힌 글리프에 원을 표시하세요. WB.mText는 16진수 색상을 사용하므로 RGB 배열이 아닌 B.hexOf(RED)를 전달하세요.
  6. 렌더링 및 검증. bun run render <slug>. 프레임 == 지속 시간 x 30; mp4의 음성 LUFS == 음성 파일 (내레이션 믹싱됨); 배경 음악은 음성보다 약 20dB 이상 낮게; 비트 끝이 아닌 중간 그리기 스틸을 사용하여 펜이 잉크 위에 있고 안전 상자를 벗어나지 않는지 확인하세요. 뉴스의 경우 1차 출처를 먼저 다시 읽고 화면의 타임스탬프를 업데이트하세요.
  7. 전달 ~/Downloads/<slug>-video/로: 전체 mp4, -small.mp4 (CRF 24), 배경 음악 wav, templates/captions.md의 캡션. 절대 경로를 제공하세요.
  8. 게시. 소유자를 대신하여 공개적으로 게시하지 마세요. 소유자를 위해 업로드하는 경우 비공개로 설정하고 YouTube의 "변경 또는 합성 콘텐츠"는 음성이 합성된 경우에만 체크하세요. 게시 버튼은 소유자가 누릅니다. 그렇지 않으면 복사-붙여넣기 키트를 제공하세요: 파일 경로, 제목, 설명, 체크할 설정.

스캐폴드

scripts/new_short.sh <slug> [--out dir] [--from template] [--kits dir] [--no-install]는 번들된 template/ (Itim + 태국어 글꼴, 안전 상자 카메라, 렌더/스틸 스크립트, 참조 비디오)를 ~/Videos/shorts/<slug>/ (또는 $SHORT_VIDEOS_DIR)로 복사하고, 이전 비디오를 _reference_*로 유지하여 적용하며, 음성 도구를 <slug>/voice/로 복사합니다. 의존성은 자동으로 설치됩니다 (--no-install는 건너뜁니다). --from <완료된 프로젝트>를 전달하면 최신 승인된 클립에서 시작할 수 있습니다.

Futurepedia Style Atlas 자료 (H 라이브러리, SOUND 키트, 프롬프트 및 참조 코드에서 포팅된 Ballpoint/Whiteboard 키트)는 이 스킬에 포함되지 않습니다. Futurepedia에 속합니다. new_short.sh는 이를 $CODE_MOTION_KITS (기본값 ~/Videos/shorts/_kits/{src/lib,src/style,prompts})에서 복사합니다. 없으면: Atlas 프롬프트를 proj/prompts/에 저장하고, bun run extract-kit prompts/<style>.md를 실행한 다음 스타일을 포팅하세요 (create-video). 해당 파일을 커밋하지 마세요.

관련 스킬