Communitygithub.com

Hownameee/짧은-비디오

Kokoro 나레이션, 발음 및 장면 단어 타이밍을 생성, 수정 또는 문제 해결합니다. 검증된 변경되지 않은 클립을 재사용하며, 설정 변경 전에 Python 환경을 검사합니다. 연구, 비주얼, 음악 구성 및 게시는 제외합니다.

짧은-비디오란 무엇인가요?

이 기술은 Kokoro TTS 엔진을 사용하여 나레이션 오디오를 생성, 수정 및 문제 해결하는 워크플로우를 제공합니다. 검증된 변경되지 않은 WAV 파일과 타임스탬프를 비트 단위로 보존하여 불필요한 재생성을 방지합니다. 변경 사항이 발생한 장면만 합성하므로 효율적이며, `--force` 플래그를 사용하여 강제 재생성할 수 있습니다. 지원되는 플랫폼은 명시되어 있지 않지만, Python 가상 환경(`.venv-kokoro`)과 특정 프로젝트 구조를 사용합니다. 기술 작동 방식은 사전 설정된 스크립트(`tools/kokoro/generate_audio.py`)를 실행하여 프로젝트 ID, 텍스트, 발음, 모델, 음성, 언어, 속도 등의 매개변수를 확인하는 것입니다. 생성 후에는 워크플로우 사전 점검을 통해 완전성과 정확성을 검증하며, 발음 매핑을 통해 약어/숫자/URL을 정규화합니다. 개발자와 AI 에이전트 사용자는 이 기술을 통해 신뢰할 수 있고 재현 가능한 나레이션 생성 워크플로우를 유지할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/kokoro-tts

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

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

문서

Kokoro 나레이션

승인된 텍스트와 공유 생성기를 사용하세요. 프로젝트별 TTS 스크립트를 복사하거나 예측된 타임스탬프를 예상 문장 타이밍으로 대체하지 마십시오.

.venv-kokoro/bin/python tools/kokoro/generate_audio.py --project projects/NNN-topic

이 도우미는 24kHz에서 미국/영국 영어 음성을 일치시키는 것을 지원합니다. 설치, 종속성 오류 또는 언어 변경에 대해서만 설정 및 언어 참조를 읽으십시오. 먼저 인터프리터/pyvenv.cfg를 검사하십시오. 종속성을 추가하기 전에 물어보십시오. 다른 언어는 지원되는 제공자 또는 오디션이 필요합니다. 영어 음성학으로 네이티브 베트남어를 약속하지 마십시오.

수정 및 재사용

안정적인 고유 장면 ID를 유지하십시오. 생성기는 텍스트/발음, 모델, 음성, 언어, 속도, 샘플 레이트, 패키지 및 생성기/캡션 코드 버전, WAV 해시/지속 시간 및 단어/캡션 적용 범위를 확인합니다. 유효하지 않은 장면만 합성됩니다. 변경되지 않은 WAV와 타임스탬프는 비트 단위로 유지됩니다. 한 번 검증된 이전 매니페스트는 채택될 수 있습니다. 완전히 변경되지 않은 실행은 매니페스트도 변경되지 않은 상태로 둡니다. 생성은 음성 디렉토리를 교체하기 전에 모든 결과를 준비합니다. 실패 시 이전 집합이 보존됩니다. 하나의 프로젝트에 대해 동시 쓰기기를 실행하지 마십시오.

--force를 사용하여 모든 클립을 의도적으로 재생성합니다. 여기에는 동일한 모델 식별자 아래에서 로컬로 캐시된 모델 가중치를 변경한 후도 포함됩니다(가중치 바이트는 캐시 키의 일부가 아닙니다). 새 모델/음성/속도는 영향을 받는 모든 클립을 무효화합니다. 음악 전용 수정은 TTS를 호출하지 않습니다.

스크립트의 발음 맵을 사용하여 약어/숫자/URL을 정규화하십시오. sourceText와 음성 텍스트를 구분하십시오. 캡션은 별도로 정렬되지 않는 한 음성 텍스트를 따릅니다. 각 의도된 구문을 한 번 말하십시오. 구두점은 타이밍을 보장하지 않습니다.

장면 프레임 전에 실제 WAV 지속 시간을 측정하십시오. 속도를 높이기 전에 밀집된 장면을 줄이거나, 늘리거나 분할하십시오. 추측된 길이에 맞추기 위해 음성을 자르지 마십시오. 원시 오디오를 보관하고 필요에 따라 별도의 패딩/리샘플링된 파생물을 만드십시오.

검증

생성 후 워크플로우 사전 점검을 실행하십시오. 완전하고 정렬된 범위 내 단어, 구문 경계, 올바른 샘플 레이트, 비어 있지 않은 디코딩 가능한 오디오 및 측정된 지속 시간이 필요합니다. 타이밍에는 실제 이전 청크 길이와 구두점 첨부가 포함됩니다. 누락/반복/잘린 단어, 발음, 일시 정지, 피크 및 끝 공간을 검토하십시오. 가능하면 들어보십시오. 예측된 정렬은 독립적인 전사가 아닙니다. 세 개의 연속 렌더링된 하이라이트와 이후 장면/청크를 기본값에 따라 검사하십시오. 수행되지 않은 청취를 기록하십시오.

Individual skills in this repo

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

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

관련 스킬