Communitygithub.com

쇼츠-스크립트-보이스

주제를 계획하고, 세로형 쇼트 비디오의 스크립트 테이블(소유자의 언어 옆에 비디오 언어 음성 라인)을 작성하고, 로컬 Kokoro TTS로 음성을 녹음하고, Whisper로 확인한 후 제목을 작성합니다. 쇼츠를 선택하거나 작성할 때, 스크립트를 수정할 때, 또는 음성을 녹음하거나 다시 녹음할 때 사용합니다. 채널 규칙은 CHANNEL.md에서 가져옵니다.

쇼츠-스크립트-보이스란 무엇인가요?

이 기술은 세로형 쇼트 비디오(예: YouTube Shorts, TikTok, Instagram Reels) 제작을 위한 스크립트 작성, 음성 녹음 및 제목 생성을 자동화하는 AI 어시전트 스킬입니다. 주제 선정부터 최종 제목까지 전체 워크플로우를 지원하며, 특히 Kokoro TTS를 활용한 로컬 음성 합성과 Whisper를 통한 음성 인식 검증을 포함합니다. CHANNEL.md 파일을 통해 각 채널의 고유한 규칙(대상 시청자, 톤, 언어, 콘텐츠 제한 사항 등)을 반영할 수 있어, 일관된 브랜드 아이덴티티를 유지하면서도 여러 채널에서 재사용 가능합니다. 스크립트는 주장 하나에 집중하고, 검증된 출처를 사용하며, 검색 최적화된 제목을 제안합니다. 사용자는 이 스킬을 통해 스크립트 초안 작성, 음성 녹음 파일 생성, 자막 타이밍 확인 및 제목 최적화까지 하나의 명령으로 처리할 수 있어 생산성이 크게 향상됩니다.

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

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

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

문서

쇼트 스크립트 및 음성 (주제 중립)

프로젝트의 CHANNEL.md를 먼저 읽으세요: 대상 시청자, 톤, 언어, 주제 및 사실 규칙, 콘텐츠 규칙, 음성 설정 및 마무리 라인 규칙은 모두 여기에서 가져오며 아래 기본값보다 우선합니다. 프로필이 명명하는 언어로 소유자와 대화하세요.

1. 주제

  • 쇼트당 하나의 주장, 이 대상 시청자에게 흥미롭거나 검색 가능한 주제로, 프로필의 콘텐츠 규칙 내에서 선택합니다. 파일에서 조사하세요: 모든 주장은 검증됨/출처 하나/미검증으로 표시하고, URL과 확인 날짜를 포함합니다. 비디오를 이끄는 주장에 대해서는 직접 주요 페이지를 열어보고 루머를 사실로 제시하지 마세요.
  • 검색 스타일 제목: 제목이 최종 확정되기 전에 플랫폼에서 동일하거나 거의 동일한 제목을 검색하고 가장 가까운 일치 항목(채널, 조회수, 게시일)을 보고합니다. 유사한 중복이 존재하는 경우 고유한 변형을 제안하세요.

2. 스크립트 파일 (<short>/script.md 또는 배치당 하나의 파일)

두 열로 구성된 테이블: 소유자 언어로 말한 내용(의미) | 비디오 언어로 된 음성 라인. 그 아래에: 출처(매체, 날짜, URL, 각각이 지원하는 내용), "말하지 않은 것" 줄(의도적으로 생략한 주장, 동기, 숫자), 큰 화면 텍스트(훅 라인 및 시리즈 탭), 제안된 제목. 길이: 속도 1.12에서 20초당 약 55-75단어. 텍스트 기본값(프로필이 재정의 가능): 접속사로 연결된 완전한 흐름의 문장, 누가 무엇을 어디서 하는지 명확, 모든 숫자와 용어 설명, 시청자에 대한 명령형 완화, 훅에서 결말까지 하나의 주장. 프로필에서 지정한 방식으로 소유자에게 스크립트를 보여주고, 프로필에서 지정한 시점에 제작을 시작하세요.

3. 음성 (로컬 Kokoro; 음성, 속도 및 언어는 프로필에서 가져옴)

  1. <short>/vo/beats.json: {"lead": 0.0, "voice": "<voice>", "speed": 1.12, "lang": "<code>", "beats": [["hook", "text...", 0.3], ["id", "text...", pause_after_s], ...]}. 숫자는 철자로 표기하세요. 두문자어와 브랜드 이름은 실제 발음되는 대로 작성하세요. 마지막 비트는 pause를 0으로 설정합니다. (voice, speed, lang은 생략 가능: 기본값은 각각 am_puck, 1.12, en-us이며, 환경 변수 SHORTS_VOICE, SHORTS_SPEED, SHORTS_LANG도 동일하게 작동합니다.)
  2. $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json 명령어로 vo/vo.wav와 vo/timings.json 파일을 생성합니다.
  3. $SHORTS_HOME/venv/bin/python _tools/words.py <short>/vo 명령어로 vo/words.json 파일을 생성합니다(Whisper 단어 타이밍, 언어는 beats.json에서 가져옴).
  4. words.json의 트랜스크립트를 읽으세요. Whisper가 단어를 잘못 들었다면, 청취자도 마찬가지일 수 있습니다: 해당 라인을 다시 작성하고 다시 녹음하세요(문장 처음의 "And", "So", "Load", 두문자어 및 이름이 일반적입니다). 캡션만 수정이 필요한 경우(예: 이름이 두 단어로 읽힌 경우), vo/words-captions.json에서 수정하고 오디오는 그대로 두세요.
  5. 소유자가 삭제한 마지막 비트는 _tools/trim_last_beat.py로 잘라내고 전체를 다시 녹음하지 마세요.

4. 제목 및 텍스트

핵심 키워드를 앞에 배치한 검색 형태의 제목. 설명과 태그는 패키징 단계(기술 shorts-packaging)에서 추가됩니다. 시청자를 위한 질문은 프로필에서 지정한 위치(음성 라인 또는 고정 댓글)에 배치됩니다.

스크립트를 넘기기 전에 확인할 사항

  • 하나의 주장; 모든 숫자 설명; 사실 출처 명시; 출처가 말하지 않은 내용 없음; 프로필이 스포일러를 금지하는 경우 스포일러 없음.
  • 말한 길이가 계획과 일치하는지 확인(timings.json 총합); 마무리 라인이 프로필을 따르는지 확인.

Individual skills in this repo

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

관련 스킬