종이 공예 설명 영상 (Papercut Explainer)

약 20~45초 분량의 세로형 설명 영상입니다. 레이어드 제작용지 같은 질감의 종이 소품과 드롭 섀도우, 뻣뻣한 컷아웃 애니메이션, 느린 카메라 푸시와 함께 스톱모션 종이 '보일' 효과, 각 비트마다 테이프로 고정된 헤드라인 배너, 단어 단위로 찢어진 종이 캡션 태그가 특징입니다. Remotion을 사용하며, AI 생성 텍스처 에셋과 모든 TTS를 선택적으로 사용할 수 있습니다.

모든 비트는 세 가지 트랙을 실행합니다:

음성 해설이 이야기를 전달합니다.
테이프 배너는 음성 해설이 생략한 중요한 사실을 추가합니다.
새로운 종이 세트가 음성 해설을 시각화하며, 제품 UI를 대략적인 종이 공예로 재구성하여 데모를 보여줍니다.

스타일과 스토리텔링 방식을 재사용하되, 예제의 내용은 재사용하지 마십시오. 모든 제품, 회사, 예제의 숫자는 가상입니다. 스타일 규칙은 $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md (섹션 2는 스타일 DNA)에 있습니다.

사전 점검

라이브러리. $MOTION_LIB를 확인하고, 없으면 ${XDG_CONFIG_HOME:-~/.config}/motion-explainer/config.env의 MOTION_LIB= 줄을 읽고, 그래도 없으면 한 번 묻습니다. 머신 경로를 하드 코딩하지 마십시오. 1~4단계는 라이브러리가 필요 없습니다.
설치 모드. 단계를 실행하기 전에 먼저 확인합니다 (아래 설치 모드 참조).
시리즈. 시리즈 폴더(episodes/ 폴더를 포함)를 찾습니다. 존재하는 경우 SERIES.md를 읽습니다.

실행 모드 (먼저 물어보세요)

전체 영상, 아이디어에서 MP4까지: 1~8단계 실행 후 게시 후 9단계 실행.
대본만: 전략, 훅, 대본 (스테이징 테이블까지만 실행).
기존 대본으로 스토리보드: motion-storyboard. 대본, 사실 및 HOOK 블록을 요청합니다.
다른 도구용 스타일 프롬프트: $MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md에서 적절한 블록을 제공하고 중단합니다.
한 장면 수정 또는 재구축: motion-build (장면 단계) 후 motion-qa 실행.

정보 수집 (누락된 것만 질문)

출처: 일반적으로 링크 (저장소, 제품 사이트, 공지사항). 이 외의 모든 정보는 출처를 통해 조사합니다.
영상이 증명할 한 가지 주장과 주제.
역할 프레이밍: 누가 또는 무엇이 작업을 수행하고, 누가 조언하거나 승인하는지. 사용자와 확인하고 제품 동작을 절대 임의로 만들지 마십시오.
CTA 키워드와 시청자가 얻는 것 (산출물).
길이: 기본값 22~30초.
시청자 수준 (SERIES.md에서 확인) 및 악센트 색상이나 마스코트.

답변을 episodes/NN-slug/research/facts.md 상단의 BRIEF 블록 형식으로 작성합니다 (형식은 motion-strategy 참조).

단계

#	단계	스킬	읽기	쓰기
1	전략 (Strategy)	`motion-strategy`	`SERIES.md`, 출처	`research/facts.md`의 BRIEF, `SERIES.md`
2	훅 (Hook)	`motion-hook`	BRIEF	`video/STORYBOARD.md` 상단의 HOOK 블록
3	대본 (Script)	`motion-script`	BRIEF, HOOK	`research/facts.md`, `narration/script.json`, `STORYBOARD.md`의 스테이징 테이블
4	스토리보드 (Storyboard)	`motion-storyboard`	`script.json`, `STORYBOARD.md`	`STORYBOARD.md`의 카메라/컷 테이블, 장면 블록, SFX 계획
5	스캐폴드 및 계획 (Scaffold and plan)	`motion-build`	`STORYBOARD.md`	프로젝트, `episode.json`
6	음성 및 타이밍 (Voice and timing)	`motion-voice`	`script.json`, `voice/voice.json`	`narration/` 테이크, `public/vo/captions.json`, `src/plan.json`
7	장면, 사운드, 렌더링 (Scenes, sound, render)	`motion-build`	`plan.json`, `STORYBOARD.md`	`src/scenes/`, `tools/cues.json`, `out/.mp4`
8	QA	`motion-qa`	스틸 이미지, `STORYBOARD.md`	수정 사항, 전달 요약
9	게시 후 (After posting)	`motion-strategy` (분석), `motion-build` (수집)	플랫폼 수치, 프로젝트	`research/analytics/`, 라이브러리 프로모션

프로젝트 파일

파이프라인은 채팅이 아닌 파일에서 실행됩니다. 각 단계는 위 파일을 읽고 자체 파일을 작성하므로, 새 세션에서도 모든 단계에서 재개할 수 있습니다.

<series>/
  SERIES.md                  선택 사항: 시청자, 음성, 팔레트, 마스코트, 키워드 로그
  voice/voice.json           선택 사항: 음성 설정 (library/voice/voice.example.json 복사)
  video-assets/              선택 사항: 오버레이 텍스처 및 소품
  research/analytics/        선택 사항: 경쟁사 연구 및 분석
  episodes/NN-slug/
    research/facts.md        BRIEF + 출처가 포함된 사실
    narration/script.json    [{"id": "l1_hook", "text": "..."}, ...]
    video/
      episode.json           장면, 배너, 훅, 간격, 배경 음악, 컷
      STORYBOARD.md          HOOK, 스테이징 테이블, 카메라/컷 테이블, 장면 블록

라이브러리 카탈로그: style/$MOTION_STYLE/remotion/CATALOG.md (모든 키트 구성 요소) 및 $MOTION_LIB/core/audio/CATALOG.md (모든 SFX 및 배경 음악). 이들은 자동 생성되므로, 새로 체크아웃한 경우 누락되거나 오래된 버전이 있을 수 있습니다. python3 $MOTION_LIB/core/tools/catalog.py를 실행하여 다시 빌드합니다. 에이전트는 키트 소스가 아닌 카탈로그를 읽습니다.

새로 작성하기 전에 재사용: 키트 구성 요소, 소품 세트 또는 장면 템플릿이 새 드로잉 코드보다 우선합니다. SFX와 배경 음악은 이름으로 선택합니다.

설치 모드

최소 (Minimal) (스킬만): 전략, 훅, 대본, 스토리보드, 스타일 프롬프트. 렌더링 없음.
표준 (Standard): 최소 + $MOTION_LIB/core/tools/placeholder_vo.py를 통한 대체 음성(무음 또는 macOS say)으로 빌드 및 렌더링, 스틸 QA, SFX 및 배경 음악 오디오, 전체 MP4.
전체 (Full): 표준 + 로컬 Qwen3-TTS 음성 해설 및 실제 오디오로부터 단어 단위 타임드 캡션.

탐색(읽기 전용):

. "$(grep '^MOTION_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/motion-explainer/config.env" | cut -d= -f2-)/env.sh"   # MOTION_PY, QWEN_TTS_PY 설정
node -v; ffmpeg -version | head -1
"$MOTION_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'

처음 세 줄이 통과하면 표준 모드입니다. qwen_tts 임포트도 통과하면 전체 모드입니다. 단계에 필요한 설치 사항이 제공된 것보다 더 많은 경우, 한 줄로 설명하고 저장소 루트에서 ./install.sh --doctor를 실행한 후, 임시 방편 대신 motion-setup에 인계합니다. 루트는 설치된 스킬 폴더(.claude/skills, .agents/skills, .config/opencode/skills 또는 다른 하네스의 skills 폴더 아래)에 대해 readlink를 사용하거나 설정 파일의 MOTION_HOME을 통해 찾습니다.

단계 간 규칙

전략 노트가 스타일 노트보다 우선합니다: 22~30초, 뉴스 형식의 훅 금지.
독립적인 작업(장면 그룹, 배경 및 소품, 재렌더링)은 에이전트로 한 번에 병렬 처리합니다.
요청 시에만 렌더링합니다. Remotion Studio에서 미리 봅니다.

공유 참조

$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md: 스타일 DNA, 종이 공예 드로잉, 팔레트, 폰트, 텍스처, 카메라 및 지터, 모션 타이밍, 캡션, 사운드.
$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md: 다른 에이전트 및 생성기를 위한 이식 가능한 프롬프트.
$MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: 키트 구성 요소와 헬퍼에 매핑된 애니메이션의 12가지 원칙. 각 단계별 사용 노트 포함.
$MOTION_LIB/style/$MOTION_STYLE/remotion/RECIPES.md: 라이브러리가 없을 때 사용하는 Remotion 구성 요소 스케치.
$MOTION_LIB/style/$MOTION_STYLE/docs/asset-prompts.md: 코드로 생성할 것과 빌드할 것, 프롬프트 템플릿 포함.
$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md: 0.2초 해상도로 작성된 약 28초 예제. 이벤트 밀도는 복사하되 내용은 복사하지 마십시오.

인계

전체 영상의 경우 1단계에서 시작하고, 실행 모드가 지정하는 단계에서 시작합니다. 정보 수집 후 motion-strategy를 실행합니다. SERIES.md와 BRIEF를 읽고 motion-hook에 인계합니다. 각 단계 스킬은 다음 스킬을 지정합니다.

motion-explainer