Communitygithub.com

motion-craft

코드 기반의 애니메이션 설명 동영상 및 시네마틱 쇼츠를 제작하는 스킬입니다 (9:16 쇼츠 및 16:9 비디오, 15초~10분). 16가지 스튜디오급 시각 카테고리(3D, 아이소메트릭, 하우스 디스어셈블리, 3D 스틱맨, 천문학, 동물의 왕국, 3D 해양, 과학 & 자연, 역사, 지도, 이슬람, 지리, 해부학, 민담, 만화, 2D 애니메이션)를 지원하며, 시각적 추천, 단계별 대본(HOOK -> 장면 1..N), 브라우저에서 바로 실행되는 독립형 HTML 파일, 소스 코드 ZIP 패키지, 결정론적 MP4 비디오 렌더링을 생성합니다.

motion-craft란 무엇인가요?

MotionCraft는 AI 에이전트가 사용자의 간단한 아이디어 하나를 완전한 애니메이션 설명 동영상 또는 쇼츠로 변환할 수 있게 해주는 독립형 범용 스킬입니다. 이 스킬은 3D, 아이소메트릭, 3D 스틱맨, 천문학, 역사 지도 등 16가지 시각적 카테고리를 지원하며, 각 카테고리는 미리 정의된 고품질 코드 예제(골든 쇼케이스)를 기반으로 합니다. 작업 흐름은 5단계로 구성됩니다: (1) 시각적 추천 및 단계별 대본(HOOK → 장면) 생성, (2) 해당 카테고리의 레시피 및 골든 코드 예제 참조, (3) 결정론적이고 반응형인 `sceneCode` JavaScript 함수 작성(Canvas/WebGL 기반), (4) `build.mjs` 스크립트를 사용하여 독립형 HTML 파일, 소스 ZIP, 대본 문서 조립, (5) 선택적으로 `export-mp4.mjs`를 사용하여 MP4 비디오 렌더링. 이 스킬의 핵심은 100% 결정론적(난수 생성기(Date.now(), Math.random()) 사용 금지), 반응형(9:16 및 16:9 모두 지원), 그리고 '제로 앱 의존성'(Node.js 표준 라이브러리만 사용)이라는 점입니다. HTML 결과물은 WebAudio SFX, 자동 루프, 종횡비 전환 버튼이 포함되어 브라우저에서 바로 실행됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 터미널 및 파일 시스템에 접근할 수 있는 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

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

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

문서

MotionCraft — 애니메이션 설명 동영상 및 쇼츠 16개 카테고리를 위한 범용 에이전트 스킬

독립형 스킬(제로 앱 의존성)으로, 1문장짜리 스토리 아이디어를 시각적 방향 추천, 단계별 대본(HOOK → 장면 1 → 장면 2 → ... 최대 10분), 독립형 <슬러그>.html 파일(더블 클릭으로 브라우저에서 바로 실행, 9:16 ↔ 16:9 종횡비 전환 버튼 및 WebAudio SFX 포함), 소스 코드 패키지 <슬러그>-source.zip, 그리고 .mp4 비디오 렌더링으로 변환합니다.


필수 작업 흐름 (5단계)

1단계 — 시각적 추천 및 대본 계획 (HOOK → 장면 1..N)

사용자가 스토리 아이디어를 제공하면 (종횡비나 시간이 명시되지 않은 경우, 짧은 사실 설명에는 기본값 9:16 쇼츠 30–45초, 심층 논의에는 16:9 비디오 60–600초 사용):

  1. 16개 공식 카테고리 중 가장 적합한 1개 카테고리 선택: 3D · 아이소메트릭 · 하우스 디스어셈블리 · 3D 스틱맨 · 천문학 · 동물의 왕국 · 해양 · 과학 & 자연 · 역사 · 지도 · 이슬람 · 지리 · 해부학 · 민담 · 만화 · 2D 애니메이션.
  2. 구체적인 시각적 추천 수립:
    • 객체 및 소품 (objek): 질감/관절이 있는 주요 주제 + 최소 3개의 크기 비교/증거용 소품.
    • 카메라 및 전환 (kamera): 멀티 샷 패턴 (와이드 → 클로즈업 디테일 → 오빗 / whipTo / pull-back).
    • 분위기 및 조명 (suasana): 하늘/공간 분위기, 안개/볼류메트릭 라이트, 색상 팔레트, 내레이션 톤.
  3. 단계별 대본 작성 (0초부터 DUR초까지 빈틈없이) :
    • 첫 부분은 반드시 HOOK이어야 함 (호기심을 유발하는 3~10초 오프닝).
    • 그 다음 장면 1, 장면 2, ...로 이어지고 강력한 사실적 결론으로 마무리 (~초당 2.2단어).
    • 긴 시간(60초 초과 ~ 600초 / 10분)의 경우 10분 장편 가이드를 참조하세요.

2단계 — 카테고리 레시피 및 골든 코드 예제 읽기 (필수!)

빈 추측으로 sceneCode를 작성하지 마세요! 애니메이션 코드를 작성하기 전에:

  1. 16개 카테고리 카탈로그에서 카테고리 테이블 및 style ID를 읽고, 엔진 v4 API 참조(MF)에서 런타임 함수 목록을 읽으세요.
  2. 가장 가까운 공식 소스 코드 예제를 골든 코드 참조 표준에서 읽으세요.
  3. 품질 동등성의 법칙: 객체 밀도, 텍스처 디테일(CanvasTexture / 레이어드 SVG / world-atlas 해안선 / GLSL 셰이더), 조명, 카메라 부드러움은 golden-showcases.md의 예제와 반드시 동등해야 합니다. 텍스처나 소품 없이 평범한 사각형/원을 그리는 것은 금지됩니다!

3단계 — sceneCode 작성의 황금률

sceneCode는 (MF, stage, tl, W, H, DUR) 함수의 본문으로 실행됩니다:

  • 이중 반응형 (9:16 쇼츠 & 16:9 비디오): 항상 W와 H 비율을 사용하세요(W * 0.5, H * 0.45, size: W < H ? 50 : 56, labelX: W < H ? W * 0.08 : W * 0.54). 1080×1920 및 1920×1080 모두에서 애니메이션이 잘리지 않고 완전히 표시되도록 합니다.
  • 변수 H를 덮어쓰지 마세요: const { H } = MF;를 절대 작성하지 마세요. 스테이지 높이 H를 덮어씁니다! 항상 MF. 접두사를 사용하여 호출하세요(MF.H, MF.S, MF.T).
  • 100% 결정론적: Math.random(), Date.now(), setTimeout 또는 setInterval 사용을 금지합니다. MF.rng('고정-시드'), tl의 트윈, 그리고 시간 t의 순수 함수인 MF.onTick((t) => ...)을 사용하세요.
  • 0번 프레임이 바로 활성화: 스테이지 요소와 HOOK 오프닝 제목은 첫 프레임이 비어 있거나 어둡지 않도록 at: 0을 사용해야 합니다.
  • PPT 금지: 한 번에 최대 1개의 헤드라인(MF.highlightHeadline) + 1개의 콜아웃/숫자(MF.leaderCallout / MF.bigStat)만 사용하세요. 이야기는 텍스트 카드의 나열이 아닌, 세계/객체의 액션 변화와 카메라 움직임으로 전달되어야 합니다!

4단계 — 독립형 파일 조립 (.html, -source.zip, -대본.md)

JSON 사양 파일 생성 (예: spec.json):

{
  "title": "비디오 제목",
  "idea": "사용자의 원본 스토리 아이디어",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objek": "...",
    "kamera": "...",
    "suasana": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "장면 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

그런 다음 독립형 빌드 스크립트(순수 내장 Node.js, npm 의존성 0개!)를 실행합니다:

node "<스킬-경로>/scripts/build.mjs" --spec path/to/spec.json --out-dir path/to/output

이 스크립트는 sceneCode의 구문과 결정론을 검증하고, ./assets/motion-engine.js, ./assets/sfx-synth.mjs 및 (지도를 사용하는 경우) ./assets/land-110m.json을 임베드한 후 다음을 생성합니다:

  1. <슬러그>.html — 모든 브라우저에서 볼 수 있는 독립형 파일 1개 (자동 루프 + 스크러브 바 + 9:16 ↔ 16:9 전환 버튼 + WebAudio SFX).
  2. <슬러그>-source.zip — 전체 소스 코드 아카이브 (index.html, src/scene.js, src/project.json, 대본-및-스토리보드.md, engine/).
  3. <슬러그>-대본.md — 깔끔한 대본 및 시각적 추천 문서.

셸/웹 채팅 없는 경우: 에이전트 환경에 Node.js 터미널 접근 권한이 없는 경우, ./assets/starter-template.html의 내용을 복사하고 /*__MOTION_ENGINE__*/, /*__SFX_SYNTH__*/ 및 /*__PROJECT_JSON__*/ null 플레이스홀더를 직접 대체하여 완전한 index.html 파일을 생성합니다.

5단계 — 프레임 확인 및 MP4 비디오 내보내기 (선택 사항 / 헤드리스 브라우저 사용 가능 시)

환경에 Chrome/Edge + puppeteer-core(또는 puppeteer)가 있는 경우, 자동 확인을 실행하여 0 런타임 오류를 보장하고 스크린샷 결과를 확인합니다:

# 빠른 확인 (0개 오류 확인 + HOOK 및 중간 스크린샷 저장):
node "<스킬-경로>/scripts/export-mp4.mjs" --html path/to/output/<슬러그>.html --verify-only

# 전체 MP4 비디오로 렌더링 (H.264 + AAC SFX 자동, 선택 사항 --vo narration.mp3):
node "<스킬-경로>/scripts/export-mp4.mjs" --html path/to/output/<슬러그>.html --fps 30 --scale 1

확인 스크린샷에서 오류나 텍스트 겹침이 발견되면 sceneCode를 수정하고 scripts/build.mjs로 다시 빌드한 후 결과를 사용자에게 제출하세요.

관련 스킬