Communitygithub.com

모션 에듀케이터

교육용 모션 비디오(설명 영상, 강의, 컨셉 필름, 숏츠, '비디오 에두카시')를 코드로 제작된 프리미엄 필름으로 만듭니다. 셰이더 무대, 유리 패널, 메탈 서체, 3D 오브젝트, 다이어그램, 차트, 캡션, 나레이션, 음악 및 음향 효과를 프레임 단위로 렌더링하여 MP4(가로 16:9 또는 세로 9:16)로 출력합니다. 항상 먼저 스토리보드를 작성합니다. 각 장면에 대한 자세한 그림 프레임이 포함된 일러스트레이션 스토리보드를 작성하고, 도구로 검증한 후 사용자에게 보여줍니다. 나레이션은 대화체(인도네시아어 또는 영어)로 작성되며, ElevenLabs로 원테이크로 녹음되고, 영상은 음성에 맞춰 편집됩니다.

모션 에듀케이터란 무엇인가요?

**모션 에듀케이터**는 개발자와 AI 에이전트가 교육용 모션 비디오(설명 영상, 강의, 숏츠)를 코드 기반으로 제작할 수 있게 해주는 전문 스킬입니다. 이 스킬은 Three.js와 GSAP을 기반으로 한 맞춤형 엔진을 제공하며, 스토리보드 중심의 워크플로우를 통해 각 장면의 시작과 끝을 정의하고 프레임 단위로 렌더링하여 품질과 일관성을 보장합니다. 주요 대상은 Claude Code, Cursor, Codex 등의 AI 코딩 에이전트이며, 사용자가 'X는 어떻게 작동하나요?', 'X는 왜 그런가요?'와 같은 교육용 비디오 제작을 요청할 때 활성화됩니다. 이 스킬은 페다고지 참고 자료를 통해 교육적 설계를 안내하고, ElevenLabs를 이용한 나레이션, 음악 및 음향 효과 믹싱, 그리고 엄격한 검토 프로세스를 포함한 완전한 파이프라인을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

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

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

문서

모션 에듀케이터은(는) 무엇을 하나요?

당신은 20초에서 120초 분량의 고급스러운 교육용 필름(가로 설명 영상 또는 세로 숏츠)을 제작하며, 하나의 주제를 효과적으로 가르칩니다. 이 필름은 일시 정지된 타임라인이 있는 웹 페이지와 같습니다. 모든 프레임은 탐색을 통해 그려지므로, 어떤 프레임도 손실되지 않으며, 각 장면을 개별적으로 수정하고 다시 렌더링할 수 있습니다. 이 스킬의 핵심은 바로 그 엔진입니다. examples/ 디렉토리에는 이 스킬을 따라 제작된 완성된 필름들(각각 스토리보드, 소스 코드, 큐 시트, 나레이션 포함)이 들어 있습니다. langit-biru(캡션 전용, 가장 많이 검토됨)와 petir-guntur(나레이션 포함 숏츠)를 먼저 읽어보십시오.

현재 단계에 필요한 참고 자료만 읽으십시오.

단계읽을 자료
무엇을, 어떤 순서로 가르칠지 결정하기references/pedagogy.md
스토리보드 작성 및 그림 그리기 (게이트)references/storyboard.md
비주얼 스타일, 악센트, 스테이지 라이트, 3D 선택하기references/look.md
키트로 필름 제작하기references/engine.md, 그 다음 references/motion.md
나레이션 작성: 캡션이 아닌 대화체; 인도네시아어 및 영어 레지스터references/narration.md
음성: 선택, ElevenLabs로 원테이크 녹음, 음성에 맞춰 영상 편집references/voice.md
음악, 음향 효과, 믹싱references/sound.md
렌더링 확인 및 독립 검토references/review.md
브라우저 대신 raea로 렌더링references/raea.md

절대 변하지 않는 규칙

  1. 스토리보드 우선, 그리고 그림으로 그려야 합니다. storyboard.json이 kit/tools/storyboard.mjs 검사를 오류 없이 통과하고 사용자가 스토리보드를 확인하기 전까지는 어떤 필름 파일도 작성되지 않습니다. 모든 장면에는 그려진 프레임(시작, 진행, 종료)이 있으며, 실제 프레임 좌표로 스케치되어야 빌드를 바로 시작할 수 있습니다. 사용자가 무인 실행을 요청하면 스토리보드를 전송하고 계속 진행하고, 그렇지 않으면 사용자의 승인을 기다려야 합니다.
  2. 출처가 명확해야 합니다. 화면에 표시되는 모든 숫자와 주장은 출처와 함께 스토리보드의 사실 시트에 기록되어야 합니다. 출처를 확인할 수 없으면 언급하지 마십시오. 그려진 내용은 기록된 내용과 일치해야 합니다. 숫자를 나타내는 막대, 미터 또는 경로는 해당 숫자로 계산되어야 하며, 축척이 아닌 다이어그램은 화면에 그 사실을 명시해야 하고, 숫자는 실제 값으로 표시되어야 합니다(거짓된 값을 통해 카운트 업하지 않음).
  3. 무음 상태에서도 설명이 가능해야 합니다. 화면의 그림과 텍스트가 설명을 전달하고, 음성과 사운드는 그 설명을 강화합니다. 처음 보는 시청자가 소리를 꺼도 무엇을 배웠는지 말할 수 있어야 합니다. 전체 설명의 핵심이 되는 단계는 메커니즘(무엇이 들어가고, 무엇을 만나고, 무엇이 나오고, 어디로 가는지)으로 그려져야 하며, 캡션에만 의존해서는 안 됩니다.
  4. 단일 시계. 모든 애니메이션 값은 타임라인의 시간에 대한 함수입니다. CSS 애니메이션, requestAnimationFrame 루프, Date.now(), 시드되지 않은 무작위성은 사용하지 않습니다.
  5. 스토리보드가 시간의 근원입니다. 필름은 storyboard.json에서 장면의 시작과 끝을 읽습니다. 캡션과 챕터 레일은 이 파일에서 생성됩니다. 계획을 변경하려면 스토리보드에서 변경하고, 필름에서 수동으로 변경하지 마십시오. 음성이 있는 필름의 경우, 녹음된 테이크가 시간을 기록합니다(voice.mjs).
  6. 자신의 작업을 평가하지 마십시오. 전체 렌더링 전에 각 장면의 스틸 이미지를 확인하고, 렌더링에 대한 측정을 수행하며, 빌드에 참여하지 않은 새로운 검토자가 결과를 평가합니다(references/review.md).
  7. 음성이 있는 필름은 대화체로 작성되고 원테이크로 녹음됩니다. 대본은 완전히 작성된 후 어떤 장면도 존재하기 전에 소리 내어 읽어집니다. 한 번에, 시작부터 끝까지 녹음되며, 화면은 음성에 맞춰 편집됩니다. 장면당 한 문장, 문장당 한 번 녹음, 계획에 맞추기 위해 일시 중지를 자르지 않습니다.
  8. 확인되지 않은 것을 말하십시오. 당신은 청각 데이터를 처리할 수 없습니다. 믹스가 측정을 통해 설정되었음을 밝히고, 사람이 들어야 할 것을 명명하며, 전체 믹스와 함께 음악 전용 버전을 제공하십시오.

작업 흐름

0. 작업 공간

키트는 사용자의 프로젝트에 복사되어 사용되며, 스킬 자체 폴더에서 사용되지 않습니다.

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # kit/와 package.json이 없으면 복사하고 films/<film-name>/을 스캐폴딩합니다.
cd <workspace> && npm install                            # three.js, GSAP, 폰트
sh kit/audio/fetch.sh                                    # 사운드 라이브러리 (커밋되지 않음: 라이센스)

Node 20+, Playwright(Chromium 포함), FFmpeg, 그리고 믹싱을 위한 Python 3(numpy 필요)가 필요합니다. node kit/tools/doctor.mjs 명령어로 모든 항목을 확인하고 설치해야 할 사항을 알려줍니다. 1080x1920 숏츠를 원하면 new.mjs에 --portrait 플래그를 추가하십시오.

1. 브리핑 (스토리보드 헤드에 몇 줄)

시청자는 누구인지, 이미 알고 있는 것은 무엇인지, 그리고 약속: 시청자가 시청 후 말할 수 있는 한 문장. 하나의 필름, 하나의 약속. 주제에 두 가지 약속이 필요하다면 두 개의 필름으로 만드십시오. 시청자가 읽는 언어, 형식(강의용 가로, 숏츠용 세로), 그리고 필름이 음성으로 설명하는지 아니면 캡션으로만 설명하는지 선택하십시오.

2. 조사 및 사실 시트

필름에서 제시할 모든 주장을 각각 출처와 함께 storyboard.json의 facts로 나열하십시오. 1차 및 기관 출처를 선호하십시오. 필요한 계산은 직접 수행하고 그 과정을 보여주십시오(예: "5,9x"와 같은 숫자는 계산된 근거와 함께 작성). 단순화하는 내용을 기록하고, 필름이 이에 대해 정직하게 다루는 방법을 결정하십시오.

3. 대본 (필름에 음성이 있는 경우)

references/narration.md를 따르십시오: 하나의 질문, 시청자의 언어 레지스터로 작성된 연속적인 대화체로, 장면 목록이 있기 전에 소리 내어 읽고 시간을 측정합니다. 그런 다음 장면으로 나눕니다. 각 음성 장면의 voice는 해당 대본의 일부입니다.

4. 스토리보드: 게이트

references/storyboard.md를 따르십시오. 간단히 말해: 액트, 그 다음 장면(약 3초마다 새로운 그림). 각 장면은 가르치는 내용, 캡션, 화면에 표시될 것, 모션, 다음 장면으로 이어지는 내용, 전환, 사운드, 확인할 사항, 인용하는 사실, 그리고 두세 개의 그려진 프레임을 포함합니다. 음악 비트에 맞춰 컷합니다.

node kit/tools/storyboard.mjs films/NAME --png     # 오류 없음, 그 다음 films/NAME/storyboard/*.png 표시

페이지를 사용자에게 보내십시오. 콘택트 시트(필름 전체 프레임)가 먼저 전송됩니다.

5. 테이크 (필름에 음성이 있는 경우)

references/voice.md를 따르십시오: 언어에 원어민인 음성을 선택하고(가능하면 두세 개를 사용자에게 들려주십시오), 전체 대본을 원테이크로 녹음하고, 필름을 그에 맞춰 편집하십시오. 스토리보드의 시간은 이제부터 테이크의 시간입니다.

node kit/audio/voice.mjs films/NAME --script                       # 녹음할 테이크
node kit/audio/voice.mjs films/NAME --generate                     # API 키 사용: 테이크 및 단어 시간
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # 음성 커넥터 사용: 둘 다 반환
node kit/audio/voice.mjs films/NAME                                # 각 장면의 시간과 들어야 할 단어

6. 빌드, 하나씩

references/engine.md를 따르십시오. 각 장면에 <section class="scene">을 지정하고 s.sNN.start와 s.sNN.end 사이에서 애니메이션을 적용하십시오. 스토리보드 순서로 빌드하고 각 장면을 완료할 때마다 스틸 이미지를 확인하십시오:

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # 완성된 프레임, 몇 초 작업

각 스틸 이미지를 그려진 프레임과 비교하십시오. 프레임이 (x, y)에 배치한 것이 (x, y)에 있어야 합니다.

7. 렌더링

node kit/tools/render.mjs films/NAME                  # out/picture.mp4, 4초 세그먼트로
node kit/tools/render.mjs films/NAME --only 12-16     # 수정 후: 변경된 세그먼트만

60fps 필름 1분은 4개의 CPU 코어로 약 30분이 걸립니다. 백그라운드에서 실행하고 그동안 큐 시트를 작성하십시오.

8. 사운드

references/sound.md를 따르십시오: 컷이 이미 맞춰진 하나의 음악 베드와 실제 이벤트에 대한 작고 깔끔한 효과음을 films/NAME/cues.json에 작성합니다. 필름용으로 작곡된 베드(kit/audio/music.mjs)는 필름이 공개될 때 라이브러리 트랙보다 더 잘 맞습니다.

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4, 완성된 파일에서 측정된 음량
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME 명령어는 4단계부터 9단계까지의 명령어를 순서대로 실행하고(확인, 음성, 렌더링, 믹싱, 측정, 공유 복사본) 첫 번째 실패 시 중지됩니다. 빌드하는 동안 스틸 이미지를 보는 것을 대체하지는 않습니다.

9. 검토, 수정, 확인

references/review.md를 따르십시오: node kit/tools/check.mjs films/NAME (콘택트 시트, 시간 고정, 음량). 그런 다음 필름, 스토리보드 및 사용자 자신의 설명을 바탕으로 새로운 검토자가 검토합니다. 가장 큰 문제를 수정하고, 변경된 부분만 다시 렌더링하며, 새로운 검토자가 수정 목록을 확인하도록 하십시오. 품질 기준에 도달하거나 개선 효과가 미미해지면 중단하십시오. 수정으로 인해 장면의 내용이 변경되면 스토리보드를 업데이트하고 다시 그리십시오. 계획과 필름은 항상 일치해야 합니다.

10. 전달

MP4(H.264, 1080p60, 약 -14 LUFS, 트루 피크 -1 dBFS 미만), 공유용 가벼운 복사본, 음악 전용 버전, 스토리보드 페이지, 그리고 짧고 정직한 노트: 측정된 것, 단지 확인된 것, 아무도 듣지 않은 것, 그리고 다음에 할 작업을 포함합니다.

필름 파일 구조

films/NAME/
  storyboard.json     계획: 사실, 액트, 장면, 그려진 프레임. 필름은 여기서 시간을 읽습니다.
  storyboard.html     스토리보드 (생성됨), storyboard/*.png 페이지들
  index.html          각 장면 또는 장면 그룹당 하나의 <section class="scene">
  film.css            이 필름의 스타일, kit/css/film.css 위에 추가
  film.js             타임라인, kit/engine/motion.js로 구축
  cues.json           음악 베드와 모든 사운드, 필름의 시계 기준
  voice/              나레이션: take.mp3, 각 단어의 시간, 컷(voice.json), 자막(subtitles.srt)
  out/                렌더링 결과 (커밋되지 않음)

작업 스타일

  • 사용자가 볼 수 있는 곳에서 계획을 세우고(스토리보드), 모든 단계에 대해 묻지 않고 빌드하십시오.
  • 작업이 오래 걸리면 한 줄로 무엇을 하고 있는지 말하십시오.
  • 작업 결과를 보여주십시오: 스토리보드, 스틸 이미지, 콘택트 시트, 측정된 숫자, 검토자의 판정.

관련 스킬