Communitygithub.com

스틱맨 애니메이션 스튜디오

하나의 프롬프트(주제, 제목, '왜 X인지 설명', 또는 비디오 개념이 담긴 TXT 파일)로 완성된 전문 영어 내레이션 스틱맨 카툰 비디오를 제작합니다. 전체 파이프라인을 포함합니다: 기능 탐색, 리서치 및 팩트체크, 영어 스크립트 및 음성 연출, 내레이션-시각 동기화 스토리보드(실행 가능한 동기화 게이트로 검증), 번들된 Remotion 엔진을 사용한 프로그래매틱 2D/3D 애니메이션, 내레이션 + 캡션 + 절차적 음악 및 효과음, 스틸 QA, 오디오 QA, 최종 렌더링 및 검증. 사용자가 비디오/숏/카툰/애니메이션 설명 영상을 만들거나 생성하라고 요청할 때 사용합니다(특히 /make-video 명령어). 모델 및 에이전트에 독립적입니다. AI 이미지 생성, AI 비디오 생성, 유료 API 사용 없음: 모든 프레임과 모든 사운드는 코드로 생성됩니다.

스틱맨 애니메이션 스튜디오란 무엇인가요?

스틱맨 애니메이션 스튜디오는 단일 프롬프트(주제, 제목, '왜 X인지 설명', 또는 비디오 개념 텍스트 파일)로부터 완전한 전문 영어 내레이션 스틱맨 카툰 비디오를 제작하는 AI 에이전트 스킬입니다. 1080×1920, 30fps, H.264+AAC 형식의 세로형 비디오를 출력하며, 모든 프레임과 사운드는 코드로 절차적으로 생성되므로 AI 이미지/비디오 생성이나 유료 API에 의존하지 않습니다. 이 스킬은 리서치 및 팩트체크, 영어 스크립트 작성 및 음성 연출, 내레이션과 시각을 동기화하는 실행 가능한 스토리보드(동기화 게이트로 검증), 번들된 Remotion 엔진을 사용한 2D/3D 애니메이션, 절차적 음악 및 효과음 생성, 스틸 QA, 오디오 QA, 최종 렌더링 및 검증의 전체 파이프라인을 자동화합니다. Claude Code, Cursor, Codex 등 다양한 코딩 에이전트와 모델에서 사용할 수 있으며, 사용자가 '/make-video' 명령어를 통해 비디오, 숏, 카툰, 애니메이션 설명 영상을 요청할 때 최적화되어 있습니다. QA 게이트를 통과한 후 검증된 MP4 파일과 소스 파일(script.md, fact-check.md, sync-map.md, 스토리 JSON 등)을 함께 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/god-dark-z/stickman-animation-studio/tree/HEAD

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

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

문서

스틱맨 애니메이션 스튜디오 — /make-video

하나의 프롬프트를 완성된 스튜디오 품질의 영어 세로형 카툰(1080×1920, 30fps, H.264 + AAC)으로 바꿉니다. 코드만 사용합니다. 스토리를 쓰고, 명시적인 내레이션-시각 동기화 계약을 통해 스토리보드를 작성하고, 번들된 엔진을 QA 게이트를 통해 실행하고, 검증된 MP4와 소스 파일을 전달합니다.

자율적으로 작동합니다. 확인 질문 없음, 진행 상황 설명 없음, 중간에 멈춤 없음. 단계가 막히면 라우팅 문제로 처리합니다: 다음 도구, 다음 에셋을 시도하거나 직접 만듭니다. 비디오가 렌더링되고, 검증되고, 전달될 때만 멈춥니다.

제작 언어는 독점적으로 영어입니다. 내레이션, 대화, 화면 텍스트, 캡션, 레이블, 삽입 복사 모두 영어입니다. 내레이션은 전문 다큐멘터리, 교육, 또는 애니메이션 스토리텔링처럼 들려야 합니다(references/10-english-voice-direction.md).

0. 기능 탐색 후 적응

제작 전에, 이 에이전트/모델이 실제로 무엇을 할 수 있는지 검사하고 워크플로우를 적응시킵니다. 추측하지 마세요; 확인하세요. 여기서 1분 투자하면 나중에 깨진 렌더링을 방지합니다.

탐색방법누락 시 → 적응
셸 + 파일 접근node --version 실행셸 없음 → 이 스킬은 렌더링 불가; install/PASTE-THIS-PROMPT.md 핸드오프로 코딩 에이전트에 전달
웹 리서치웹 검색 도구 사용 가능?검색 없음 → 내부 지식으로 작성, 모든 주장을 fact-check.md에 '미검증' 표시, 상식적인 물리/역사 주제 선호
이미지 비전이미지 파일을 읽을 수 있나요?비전 없음 → engine/scripts/qa_stills.py + engine/scripts/qa_sync.ts 픽셀/어휘 게이트에 의존하고 전달 보고서에 명시
백그라운드 실행긴 명령을 백그라운드에서 실행할 수 있나요?아니요 → 포그라운드에서 렌더링하고 먼저 --preview 사용; 몇 분 정도 예산 확보
컨텍스트 예산매우 큰 컨텍스트?제한된 컨텍스트 → references/ 파일 중 현재 단계가 명명하는 파일만 한 번에 하나씩 읽음; 스토리 JSON을 유일한 진실 공급원으로 유지
추론 깊이강력한 모델 → 제작을 더 발전시킴: 더 풍부한 스테이징, 더 많은 비트, 더 깊은 리서치약한 모델 → 참조 기본값을 문자 그대로 따름; 즉흥 없이도 좋은 결과를 내도록 보정됨

환경이 무엇이든, 품질 게이트(4, 5, 7단계)는 선택 사항이 아닙니다 — 더 약한 워크플로우도 동일한 실행 가능한 검사를 통과해야 합니다.

0.5 엔진 확인

엔진은 자체 포함된 Remotion 프로젝트입니다. 다음 순서로 찾습니다:

  1. 현재 프로젝트에서 package.json이 stickman-studio-engine이라는 이름의 디렉토리 — 사용합니다.
  2. 이 파일 옆에 있는 engine/ 폴더 — 워크스페이스로 복사(cp -r <skill-dir>/engine ./engine)하고 내부에서 npm install 실행(처음에만).
  3. 둘 다 없으면, 엔진 없이 스킬이 설치된 것임 — 스킬 리포지토리를 클론하고 거기서 engine/를 가져옵니다.

엔진 디렉토리 내부의 일회성 설정:

npm install                      # Remotion + three + zod
pip install edge-tts imageio-ffmpeg numpy scipy pillow   # 내레이션 + 절차적 오디오 + QA

65개의 SFX, 6개의 음악 배드 및 필름 그레인은 첫 렌더링 시 절차적으로 생성됩니다(다운로드 없음, 라이선스 없음, 타사 오디오 없음). 내레이션은 edge-tts를 위해 인터넷이 필요함(무료, 키 없음); --no-tts는 스테이징 작업을 위해 완전히 오프라인으로 작동합니다. 영어 음성만 — 음성 카탈로그 및 연출 규칙은 references/10-english-voice-direction.md를 참조하세요.

1. 주제 리서치 (영어)

  • 입력은 주제, 제목 또는 TXT 파일 경로입니다(주어진 경우 읽습니다).
  • 작성 전에 웹 검색으로 리서치합니다. 내레이션할 모든 사실적 주장에 대해 팩트체크 테이블(주장 | 출처 설명 | 출처 URL)을 만듭니다 → stories/<slug>/fact-check.md.
  • 소문이나 전설에 불과한 것은 삭제하거나 내레이션에서 표시합니다("전설에 따르면…").
  • 더 부드러운 가상의 세부사항보다 가장 이상한 진짜 세부사항을 선호합니다.

2. 스크립트 작성 + 음성 선택

190–210 단어 ≈ 60–75초를 목표로 합니다. 구조(정확히 따름):

  1. 1행: 평범한 사실로 제시된 역설적 훅. 인사말, "알고 계셨나요" 없음.
  2. 설정과 이해관계 — 영웅, 장소, 욕구.
  3. 고조 + 영웅을 조롱하는 짧은 인용문.
  4. 전환점 / 수사적 질문.
  5. "아시겠지만," + 메커니즘, 일상적인 비유와 삽입 그래픽 포함.
  6. 마지막 줄의 반전. 강하게 마무리.

전체 제작 규칙: references/04-script-craft.md. 스크립트를 stories/<slug>/script.md에 저장합니다.

그런 다음 렌더링 전에 음성을 연출합니다: 장르에 맞는 제공자/음성/속도를 references/10-english-voice-direction.md에서 선택(기본값: en-US-AndrewMultilingualNeural @ +22%; 차분한 다큐멘터리는 더 느리게 읽음). 확실하지 않으면 훅 라인을 빠른 합성으로 테스트합니다.

3. 에셋 확인 및 구축

  • 스토리에 필요한 것 목록: 장소, 서 있는 물체, 손에 든 아이템.
  • 존재하는 것 확인: npx tsx scripts/locations.ts --list. 구축 전에 재사용; 유사 항목을 거의 중복하지 않음; 에셋 이름은 그것이 무엇인지 나타내도록 지정.
  • 스토리보드 작성 전에 누락된 에셋 구축 — 레시피는 references/08-extending-assets.md(3D 위치 / 3D 개체 / 2D 소품 / 2D 배경 / 의상).
  • 새 3D 에셋을 npx tsx scripts/locations.ts --stills --only=<name>으로 확인합니다.

4. 동기화 계약이 포함된 스토리보드 (동기화 게이트)

stories/<kebab-title>.json을 작성합니다. 스키마 + ID: references/09-schema-reference.md, engine/src/catalog.ts. 제작 규칙: references/05-storyboard-craft.md.

내레이션-시각 동기화는 필수이며 기계적으로 검사됩니다. 모든 내레이션 세그먼트(샷의 say)는 말하는 내용을 시각적으로 보여줘야 합니다: 올바른 장소, 올바른 시간대, 설명된 동작이 포즈/비트/소품으로, 언급된 객체가 화면에, 인용된 줄이 quote 배우에 바인딩되고, 샷 간 연속성이 있어야 합니다. 샷 내부의 단어 수준 타이밍은 beats로 바인딩됩니다(at = 말한 단어).

실행 가능한 게이트를 실행하고 오류가 0이 될 때까지 반복합니다:

npx tsx scripts/qa_sync.ts stories/<file>.json            # 장소/시간/동작/객체/대화/연속성 검사
npx tsx scripts/qa_sync.ts stories/<file>.json --map      # 샷별 동기화 계약 테이블 출력
  • 모든 ERROR는 수정되어야 합니다(샷의 세계/시간/포즈/소품을 변경하거나 내레이션을 다시 표현).
  • 모든 WARN을 검토합니다; 수정하거나 stories/<slug>/sync-map.md에 그것이 허용 가능한 이유를 기록합니다 (--map으로 테이블 생성; 템플릿: templates/sync-map.md).
  • 스토리별 어휘(관용구, 발명 명사)는 stories/<slug>/sync-lexicon.json에 들어갑니다 — 템플릿 참조.

5. 스틸 게이트 (절대 건너뛰지 않음)

npm run make -- stories/<file>.json --stills        # 샷당 하나의 QA 스틸 → out/<slug>/stills/
python scripts/qa_stills.py out/<slug>/stills       # 노출/데드프레임 게이트 (실패 시 exit 1)

그런 다음 모든 스틸을 프레이밍, 얼굴, 떠다니는 소품, 가독성, 일관성에 대해 검사합니다 — 자신의 비전으로(가능한 경우), 또는 스틸별로 agentvision check <file>과 픽셀 게이트를 함께 사용.

수정하고 깨끗해질 때까지 다시 실행합니다. 이 게이트가 통과하기 전에 절대 비디오를 렌더링하지 마세요.

6. 렌더링

npm run make -- stories/<file>.json            # 전체 품질 → out/<slug>/<slug>.mp4
npm run make -- stories/<file>.json --preview  # 확실하지 않을 때 먼저 절반 크기 드래프트

가능하면 백그라운드에서 실행합니다; 관련 없는 무거운 작업을 동시에 시작하지 않습니다. 내레이션은 슬러그별로 캐시되며 스크립트/음성/속도가 변경될 때만 다시 합성합니다.

7. 확인 (ffprobe + 프레임 + 오디오 게이트)

ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,codec_name -of csv=p=0 out/<slug>/<slug>.mp4
ffmpeg -i out/<slug>/<slug>.mp4 -vf fps=1/5 qa_%03d.jpg     # 비디오 전체에서 프레임 추출
python scripts/qa_audio.py out/<slug>/<slug>.mp4            # 음량/클리핑/음성 존재 게이트
  • 사양: 1080×1920(--preview의 경우 540×960), 30fps, h264 + aac; 지속 시간 ≈ 내레이션 + 0.6초.
  • 프레임: 첫 번째/중간/마지막이 검지 않음; 캡션 읽기 쉬움; 멈춘 샷 없음.
  • 오디오 게이트는 통과해야 함: −14 LUFS ±1.5, 실제 피크 ≤ −1.0 dBTP, 음성 에너지 있음.

8. 수정 루프, 그런 다음 전달

4→7단계를 모든 게이트가 통과할 때까지 반복합니다. 예산: 게이트당 최대 3회 수정 라운드; 그 후에도 게이트가 실패하면, 남은 문제에 대한 명시적 메모와 함께 전달합니다(알려진 실패를 조용히 보내지 않음, 전달 없이 절대 멈추지 않음).

세트로 전달: MP4, script.md, fact-check.md, sync-map.md, 스토리 JSON, 새 라이브러리 에셋, 그리고 정직한 한계(검증된 사실 vs. 각색; 실행된 게이트와 검사 방법).

품질 기준 (협상 불가)

  • 동기화: 시각은 내레이션이 전달하는 것을 정확히 보여줌 — 모순 없음, 죽은 샷 없음. 내레이션과 애니메이션이 두 가지 다른 이야기를 말할 때, 스토리보드를 다시 작성합니다.
  • 표현력 있는 캐릭터: 비트에 반응, 실루엣으로 읽히는 포즈, 장면당 하나의 일관된 광원; 유휴 생동감(호흡/깜빡임/걷기)은 자동 — 그 위에 의도적인 움직임.
  • 영화 촬영법: 장면당 프레이밍 사다리, 카메라 다양성(동기화 게이트는 동일한 프레이밍+카메라 샷이 3개 연속이면 플래그 지정), 샷당 하나의 명확한 시각적 목적.
  • 사운드는 절대 음성과 싸우지 않음: 덕킹은 자동; 특정 순간에만 수동 sfx; 오디오 게이트는 음량과 클리핑 없음을 강제.
  • 반복 없음, 엉성함 없음: 프레이밍, 전환 및 반응 다양화; 샷당 ≤ 2개의 fx; 8–10개 샷당 ≤ 1개의 삽입.
  • AI 생성 이미지 또는 비디오, 이미지 생성 서비스, 유료 API 사용 금지. 절대.
  • 영어만 — 내레이션, 대화, 화면 텍스트, 캡션.

심층 참고 자료 (모두 한 번에 읽지 말고 단계별로 읽음)

파일읽을 시점
references/01-animation-principles.md모션, 이징, 예측, 보조 동작 — 엔진이 구현하는 대로
references/02-character-system.md스틱맨 리그: 비율, 체형, 포즈, 얼굴, 일관성
references/03-scenes-camera-light.md시차 레이어, 프레이밍, 카메라 움직임, 조명, 고정 팔레트
references/04-script-craft.md스크립트 구조, 훅, 비유, 단어 예산
references/05-storyboard-craft.md샷 문법, 비트, 전환, 동기화 계약
references/06-sound-design.md덕킹, 자동 SFX 맵, 음악 분위기, 편안함 규칙, 오디오 게이트
references/07-rendering-qa.md모든 QA 게이트, 픽셀 검사, ffprobe, 수정 루프
references/08-extending-assets.md레시피: 3D 위치/개체, 2D 소품/배경, 의상, sfx
references/09-schema-reference.md모든 스토리 JSON 필드, 기본값 및 제약 조건 포함
references/10-english-voice-direction.md영어 음성 카탈로그, 연출, 속도, 오프라인 폴백

관련 스킬