Communitygithub.com

cartoon-video

아이디어, 스크립트 또는 업로드된 음성 내레이션으로부터 독창적인 세로형 애니메이션 카툰 단편을 제작합니다.

cartoon-video란 무엇인가요?

이 스킬은 사용자가 완전한 음성 내레이션 중심의 세로형 애니메이션 카툰 단편을 처음부터 끝까지 제작할 수 있도록 안내합니다. Three.js 3D 세계와 평면 일러스트 스타일의 캐릭터 카드를 활용하여 독창적인 비주얼 스토리텔링을 구현하며, 1080×1920 해상도, 30fps의 9:16 세로 구도를 기본으로 합니다. 스킬은 크게 4단계로 구성됩니다: 시작점 파악, 아이디어 생성(10개 제안), 내레이션 스크립트 작성, 그리고 실제 프로젝트 구축(타이밍 분석, 촬영 계획, 세계 및 캐릭터 빌드, 사운드 디자인, 렌더링 및 MP4 내보내기)을 포함합니다. 사용자가 음성 녹음을 제공하면 이를 기준으로 모든 애니메이션 타이밍을 맞추며, Whisper 기반 음성 인식, Python 스크립트, Node.js 렌더러 등 다양한 도구를 활용합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 실행되며, 사용자의 창의적인 아이디어를 구체적인 비디오 파일로 변환하는 엔드투엔드 워크플로우를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alone-legacy/cartoon-video-skill/tree/HEAD

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

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

문서

카툰 비디오 스킬

사용자가 독창적인, 내레이션 중심의 세로형 카툰 단편을 만들 수 있도록 도와주세요. 저장소 루트가 스킬 디렉토리입니다: engine/, tools/, example/은 바로 그 안에 위치합니다(kit/ 하위 디렉토리는 없습니다). 계획에 대해 사용자에게 계속 알리고, 긴 렌더링 전에는 스틸을 검토하며, 사용할 수 없는 도구나 불완전한 단계를 정직하게 보고하세요.

창작 방향

시그니처 룩은 표현력이 풍부하고 평면적인 일러스트 캐릭터 카드가 다채롭고 입체적인 3D 세계에 배치된 것입니다: 페인트 질감, 잉크 윤곽선, 분위기 있는 조명, 피사계 심도, 부드러운 카메라 움직임. 기본값은 세로 9:16 구성, 1080×1920, 30fps입니다. 시각적 스토리텔링, 읽기 쉬운 실루엣, 의도적인 연출, 그리고 내레이션과 일치하는 반응을 사용하세요.

  • 스토리, 캐릭터, 장면 디자인은 반드시 독창적이어야 합니다. 다른 제작자의 비디오를 장면 단위로 복제하지 마세요.
  • 실제 유명 인물을 캐릭터로 만들거나 브랜드 마스코트/로고를 포함하지 마세요.
  • 요청하지 않는 한 자막을 추가하지 마세요. 게임 내 텍스트는 올바르게 방향이 지정되고 읽을 수 있어야 합니다.
  • 선정적인 내용을 피하고 실제 살아있는 사람을 조롱의 대상으로 삼지 마세요.
  • 브라우징/리서치 도구를 사용할 수 있을 때 사실적 주장을 확인하세요. 전설이나 논란이 있는 이야기를 명확히 표시하고, 바이럴 일화를 확인된 사실로 제시하지 마세요.
  • 사용자의 음성 녹음을 보존하세요. 그에 맞춰 비주얼을 타이밍하고, 애니메이션에 맞추기 위해 내레이션을 편집하거나 다시 타이밍하지 마세요.
  • 내레이션이 잘 들리도록 유지하세요. 음악과 효과는 목소리를 압도하지 말고 지원해야 합니다.

1단계 — 시작점 찾기

먼저 사용자의 메시지와 첨부 파일을 확인하세요. 음성 내레이션이 있으면 그것을 사용하고, 타이밍을 확인하는 데 필요한 경우에만 최종 스크립트를 요청하세요. 그렇지 않으면 사용자에게 음성 내레이션이 있는지, 스크립트가 있고 녹음이 필요한지, 아니면 아이디어와 스크립트 작성을 원하는지 물어보세요. 대상 길이를 모르면 물어보세요; 기본값은 20–30초이며, 요청 시 45–60초도 사용 가능합니다.

이미 제공된 정보에 대해 묻지 마세요. 다음 단계를 명확히 하고 여러 단계 작업에 대한 간결한 진행 상황 체크리스트를 사용자에게 제공하세요.

2단계 — 아이디어 (요청 시)

정확히 10개의 번호가 매겨진 아이디어를 제시하고, 사용자에게 하나를 선택하거나 더 요청하도록 하세요. 각 아이디어는 다음을 포함합니다:

  • 호기심을 자극하는 제목 (약 5–8단어).
  • 강력한 오프닝 훅을 명확하게 진술.
  • 반전/결말을 한 줄로.
  • 스토리가 왜 애니메이션에 적합한지 (2–3개의 시각적 순간).
  • 문서화된 역사인지, 논란의 여지가 있는지, 민담인지.

명확한 캐릭터, 구체적인 이해 관계, 눈에 보이는 인과 관계, 고조, 그리고 아이러니하거나 놀라운 결말을 선호하세요. 시대와 주제를 다양화하세요. 리서치 도구를 사용할 수 있을 때 사실로 설명된 내용에 대해 주요 사실을 조사하세요.

3단계 — 내레이션 작성

내레이션만 작성하세요 — 말하는 카피에 무대 지시는 넣지 마세요. 초당 약 3.7단어를 목표로 하세요 (20초에 약 75단어, 30초에 110단어, 60초에 220단어). 다음과 같이 구성하세요:

  1. 훅: 긴 설정 없이 놀라운 주장으로 시작.
  2. 설정: 구체적인 세부 사항으로 언제, 어디서, 누구인지 확립.
  3. 고조: 2–4개의 점점 더 생생한 비트를 통해 구축.
  4. 전환: 메커니즘을 설명하거나 핵심 사실을 공개.
  5. 결말: 짧고 기억에 남는 반전으로 끝.

대화체 언어, 축약형, 대부분 짧은 문장을 사용하세요. 내레이션을 향상시킬 때 숫자를 말로 쓰세요. 시청자가 이미 볼 수 있는 것을 설명하지 마세요. 복사 가능한 블록에 단어 수와 예상 길이와 함께 스크립트를 반환하고, 짧은 시각적 계획과 실용적인 녹음 지침을 따르세요. 스크립트가 승인되면 음성 내레이션을 요청하세요. 타이밍을 위해 최종 스크립트 텍스트를 유지하고, 녹음이 다르면 실제 구어체 버전을 받으세요.

4단계 — 음성 내레이션으로 구축하기

아래 단계를 진행하고 누락된 입력이 진행을 막을 때만 질문하세요. 타이밍 참조로 사용자의 승인된 스크립트를 사용하세요. 음성 인식기가 없으면 스크립트가 필요합니다: 적절한 도구 없이 오디오를 이해하거나 전사한다고 주장하지 마세요.

4.1 프로젝트 준비

스킬 키트는 저장소 루트에 있습니다. 다음을 사용하여 별도의 작업 프로젝트를 만드세요:

bash <스킬-루트>/tools/setup.sh <프로젝트-디렉토리>

<스킬-루트>에 실제 설치 경로를 사용하세요. 설정 스크립트는 engine/, tools/ 및 작업된 예제 시작 파일을 프로젝트로 복사하고, Three.js 및 캐릭터 라이브러리 코드를 업스트림 소스에서 검색할 수 있습니다. <스킬-루트>/kit/tools/setup.sh를 참조하지 마세요; 그 경로는 이 저장소에 존재하지 않습니다.

Node.js 22.6+, Python 3와 NumPy (및 접촉 시트용 Pillow), FFmpeg/FFprobe, Git, 그리고 Chromium이 포함된 Playwright를 확인하세요. 누락된 전제 조건을 설명하고 중요한 시스템 전체 변경을 하기 전에 물어보세요. TLS를 비활성화하거나, 프록시를 우회하거나, 신뢰할 수 없는 실행 파일 다운로드를 사용하여 네트워크 제한을 해결하지 마세요. Chromium 소프트웨어 WebGL은 대체 수단으로만 사용하고 느리게 렌더링될 수 있다고 경고하세요.

4.2 내레이션 타이밍 설정

프로젝트 디렉토리에서 다음을 실행하세요:

python3 timing.py voice.mp3 script.txt --out work

타이밍 도구는 가능한 경우 Whisper/faster-whisper 단어 타임스탬프를 사용합니다. 그렇지 않고 스크립트가 있으면 감지된 음성 세그먼트에 구문을 정렬합니다. work/phrases.json을 검사하고; 샷을 계획하기 전에 명백한 구문 경계 오류를 수정하세요. 총 프레임 수는 대략 duration × 30입니다. 음성 인식이나 최종 스크립트를 모두 사용할 수 없으면 추측하지 말고 스크립트를 요청하세요.

4.3 코딩 전 샷 계획

work/PLAN.md를 작성하고 샷당 한 행씩 포함하세요: 시작/종료 프레임, 말하는 구문, 설정, 조명, 카메라 움직임, 캐릭터/포즈/표정, 효과, 사운드 큐.

  • 프레임 0에 매력적인 훅 이미지를 배치하세요.
  • 일반적으로 구문당 한 샷을 사용하고, 유용한 경우 매우 짧은 구문을 결합하세요.
  • 각 문장을 구체적인 시각적 동작이나 농담을 전달하는 소품으로 보여주세요.
  • 샷 크기와 구성을 다양화하세요: 클로즈업, 와이드 리빌, 투샷, 인서트, 반응, 환경 이동.
  • 조명을 사용하여 스토리 비트를 명확히 하세요. 시간 점프를 시각적으로 이해하기 쉽게 만드세요.
  • 반전을 의도적으로 연출하고, 마지막 단어에 시각적 결말을 맞추세요.

4.4 세계와 캐스트 구축

진실의 원천으로 engine/과 복사된 프로젝트 파일을 사용하세요. example/soldier/story.js에서 web/story.js를, example/soldier/audio.py에서 복사된 오디오 큐 테이블을 각색하세요; 스킬 저장소의 예제를 덮어쓰지 마세요. 복사된 엔진 및 예제 코드의 계약 및 내보내기를 따르세요.

간단한 3D 지오메트리와 페인트 재질로 환경을 구축하세요. 깊이와 전경 객체를 연출할 때 세로 프레임을 염두에 두세요. 스토리 중심의 세트 피스를 프레임/시간으로 제어할 수 있게 만들고, 요청된 모든 프레임에 대해 세계 상태가 결정론적이도록 보장하세요. 캐릭터 카드를 읽기 쉽게 유지하고, 적절한 포즈, 표정, 깜빡임, 미묘한 유휴 움직임을 포함하세요. 내레이션에서 주의를 분산시키지 않으면서 부드러운 카메라 글라이드, 의도적인 초점, 2차 동작을 사용하세요. 다이제틱 텍스트가 반전되지 않았는지 확인하세요.

캐릭터 소스 코드가 변경된 경우 생성된 프로젝트의 문서화된 재구축 절차를 따르세요. 새 디자인에 의존하기 전에 캐릭터 테스트/접촉 시트를 렌더링하세요. 장면에서 요구하고 결과를 확인하지 않는 한 렌더러의 핵심 재질/깊이/잉크 계약을 변경하지 마세요.

4.5 사운드 디자인

예제 큐 테이블을 스토리에 맞게 각색하세요. 음악으로 분위기를 설정하고 페이싱을 지원하며, 의미 있는 동작, 전환, 폭로에 음향 효과를 사용하세요. 내레이션이 앞서 나가도록 유지하고, 효과가 그것보다 놀라게 하지 않도록 하며, 허가 없이 저작권이 있는 음악이나 효과를 사용하지 마세요. 인코딩 전에 믹스를 렌더링/확인하고, 해결되지 않은 클리핑이나 밸런스 문제를 오디오가 QA를 통과했다고 주장하는 대신 보고하세요.

최종 큐를 확정하기 전에 사진 타이밍을 고정하세요. 샷 타이밍이 변경되면 사운드 큐 타이밍과 믹스를 다시 방문하세요.

4.6 검토, 렌더링 및 마무리

각 샷의 대표 프레임과 전환 및 주요 동작을 렌더링하세요. 제공된 유틸리티로 접촉 시트를 만들고 검사하세요 (또는 사용 가능한 이미지 보기 도구 사용). 긴 렌더링을 시작하기 전에 프레이밍, 폐색, 반전된 텍스트, 빈 프레임, 조명, 캐릭터 가독성을 수정하세요. 환경이 파일 공유를 지원할 때 검토 시트와 간결한 샷 요약을 사용자와 공유한 다음 전체 렌더링을 진행하세요.

일반적인 프로젝트 명령 (생성된 프로젝트 디렉토리에서 실행):

node render.mjs stills/review "0,60,120"
python3 sheet.py stills/review stills/contact-sheet.jpg
node render.mjs frames "0-<마지막-프레임>"
bash finish.sh "단편 제목"

음성 내레이션에서 파생된 실제 프레임 범위를 사용하세요. 렌더러의 재개 모드가 복사된 버전에서 지원되는 경우에만 재개하세요. 프로세스 완료 및 오류를 확인하세요; 시작된 백그라운드 프로세스가 완료되었다고 가정하지 마세요. 마무리 유틸리티는 MP4를 인코딩하고 기본 미디어/블랙/프리즈/라우드니스 검사를 출력합니다. 최종 파일과 QA 출력을 검사하고, 검사가 실행되지 않은 경우 투명하게 알리세요.

파일 공유 도구를 사용할 수 있을 때 MP4와 샷에 대한 짧은 설명을 전달하세요. 그렇지 않으면 정확한 출력 경로를 제공하고 사용자가 어떻게 검색할 수 있는지 설명하세요. 요청된 경우에만 집중적인 수정이나 자막을 제공하세요.

저장소 및 종속성 참고 사항

  • engine/: Three.js 렌더러와 세계, 페인트, 모션 및 캐릭터 헬퍼.
  • tools/: 프로젝트 설정, 타이밍, 프레임 렌더링, 접촉 시트 및 마무리 스크립트. 스킬 저장소의 이러한 정식 스크립트를 선호하세요.
  • example/soldier/: 작업된 예제; 자동으로 반복할 스토리가 아닌 시작점으로 사용하세요.
  • 설정 프로세스는 일부 타사 종속성을 검색합니다. 해당 업스트림 라이선스를 존중하고 타사 코드의 소유권을 주장하지 마세요.
  • 생성된 오디오, 프레임, 접촉 시트 및 MP4 파일은 사용자의 작업 프로젝트에 속합니다. 개인 음성 녹음이나 비밀을 스킬 저장소에 커밋하지 마세요.

관련 스킬