Communitygithub.com

dsauce/stickman-kino

스틱맨 키노(Stickman Kino) 영화를 애니메이션화합니다. film.json/스토리보드로부터 scenes.js를 작성하고, 스틱맨 엔진을 사용하여(58개의 포즈와 IK를 가진 리깅 스틱 피규어, 약 190개의 소품, 차트 및 다이어그램, 운동성 텍스트, 캡션, 카메라 움직임, 효과, 환경, 테마, 전환) 음성 해설과 동기화한 후, check + snapshot으로 검증합니다. 모든 장면의 안무, 모션, 레이아웃 또는 시각적 수정 작업에 사용합니다.

stickman-kino란 무엇인가요?

이 스킬은 개발자와 AI 에이전트 사용자를 위해 설계된 '스틱맨 애니메이터'로서, 브라우저 기반 JavaScript 환경에서 영화 장면을 프로그래밍 방식으로 제작할 수 있게 해줍니다. `scenes.js` 파일을 작성하여 `film.json`에 정의된 각 클립(장면)에 대응하는 애니메이션을 생성합니다. 엔진은 전역 `SM` 객체를 통해 제공되며, 체인 가능한 API, 음성 동기화 큐, 레이어 시스템(월드, 백, 피규어, 프론트, UI, 탑), 다양한 전환 효과, 그리고 190개 이상의 소품과 58개의 포즈를 가진 리깅 스틱 피규어를 지원합니다. 주요 사용 사례로는 피규어의 걷기, 포인트, 생각하기 등의 제스처 연출, 막대 그래프와 같은 데이터 시각화, 운동성 텍스트 삽입, 카메라 푸시/팬 작업을 포함한 복잡한 장면 안무가 있습니다. 완료 후에는 `stickman check`와 `stickman snapshot` 명령어를 통해 오류 검증과 시각적 리뷰를 반드시 수행해야 하며, 이 과정을 통해 클리핑, 겹침, 부동 피규어, 읽기 어려운 텍스트 등을 교정합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 코딩 도구와 통합되어 개발자가 영상의 각 장면을 명령형 코드로 정밀하게 제어할 수 있도록 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsauce/stickman-kino/tree/HEAD/skills/stickman-animator

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

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

문서

스틱맨 애니메이터

당신은 **scenes.js**를 작성합니다 - film.json의 각 클립에 대해 하나의 film.scene(id, sc => { … }), 동일한 id, 동일한 순서로. 모든 것은 전역 SM 엔진을 대상으로 하는 평범한 브라우저 JS입니다. 작성하기 전에 references/api.md(전체 요약본) 및 references/cookbook.md(복사-붙여넣기 레시피)를 읽으십시오.

멘탈 모델

  • 로컬 시간. 장면 내에서 모든 시간은 클립 시작부터의 초 단위입니다. sc.dur = 클립 길이.
  • 체인 가능. 모든 액션은 종료 시간을 반환합니다: const t = bob.walkTo(900, 0.2); bob.wave(t);
  • 음성 동기화. sc.cue("단어") = 내레이터가 그 단어를 말하는 예상 로컬 시간(sc.cue(["단어", 1]) = 두 번째 발생, sc.cue(0.5) = VO의 중간 지점). 시각 요소를 단어 상단 또는 바로 앞에 배치하십시오(sc.cue("아이디어") - 0.15).
  • 레이어. world(환경) → back(소품) → 피규어 → front(피규어 위 소품) → ui(화면 공간, 카메라 무시) → top(전환). 소품에 { layer: "front" } / "ui"를 전달하십시오.
  • 좌표. 캔버스는 sc.W × sc.H(1920×1080, 1080×1920 또는 1080×1080)입니다. sc.groundY는 바닥입니다(가로에서 80% 아래, 세로에서 74% 아래). 피규어는 y = 피트 위치에 서 있습니다.
  • 사물. 소품, 텍스트, 차트, 도형은 Thing입니다: .pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show.
  • 등장 전까지 숨김. { hidden: true }로 생성한 후 .pop(t); 텍스트는 .in(t, fx)까지 숨겨집니다.

장면 스켈레톤

const film = SM.film();                       // 테마/포맷은 film.json에서 옴

film.scene("hook", sc => {
  sc.enter("fade");                           // 선택 사항, 이전 종료와 일치
  sc.ground();                                // 바닥선 (스타일: "grass" | "none")
  const bob = sc.figure({ x: -150, face: "dots" });        // 또는 sc.character("zeke", {...})
  const t1 = bob.walkTo(sc.W * 0.35, 0.2);
  bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("this"));
  const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
  chart.grow(sc.cue("grew"));
  sc.text("Revenue [doubled]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("doubled") - 0.1, "words");
  sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3);   // 느린 푸시
  sc.exit("wipe-left");
});

인트로 및 아웃트로

film.json에서 "intro" / "outro"를 선언한 클립은 자체적으로 빌드됩니다. 이를 위한 장면을 작성할 필요가 없습니다. 추가 요소(제목 주위에 터지는 소품, CTA에 손을 흔드는 피규어)를 추가하려면 장면을 작성하고 프리셋을 직접 호출하십시오. 그러면 자동 버전은 건너뜁니다:

film.scene("intro", sc => {
  const t = sc.intro("countdown", sc.clip.intro);          // 제목이 안착된 시간 반환
  sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
  sc.exit("wipe-left");
});
film.scene("outro", sc => {
  sc.enter("fade", { color: "bg" });
  sc.outro("kino", sc.clip.outro);
  sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});

연출 규칙 (멋지게 보이게 하는 법)

  1. 2-3초마다 무언가 변경됩니다. 클립당 3비트(beat)를 계획하십시오; 빈 공간을 카메라 푸시, 깜빡임/고개 끄덕임, 소품 바운스, 하이라이트로 채우십시오.
  2. 애니메이션 전에 무대를 설정하십시오. 피규어, 주요 소품 및 텍스트가 배치될 위치를 결정하십시오(16:9에서는 3분할, 9:16에서는 쌓기). 텍스트를 피규어의 머리 및 다른 텍스트로부터 멀리 유지하십시오.
  3. 피규어는 서 있지 않고 행동합니다. 의미 있는 제스처를 사용하십시오: 논의되는 것을 point, 아이디어 전에 think, 공개 시 surprise, 신화에 shrug, 승리에 celebrate, 노력에 push/climb/runTo.
  4. 한 번에 하나의 초점이 되는 등장; 여러 개가 나타날 때 0.1-0.2초 간격을 두십시오.
  5. 클립 간 종료와 시작을 일치시키거나(동일한 전환 유형) 매치 컷(동일한 포즈/객체 위치)을 사용하십시오.
  6. 색상은 의미를 전달합니다: "a1" 문제, "a2" 해결책, "a3" 보상. 색상 이름을 전달하십시오: "a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper" 또는 16진수.
  7. 기준 진실: 피규어는 sc.groundY(또는 계산한 표면) 위에 서 있습니다; 바닥에 놓이는 소품은 y = sc.groundY - size*0.4를 사용합니다.
  8. 세로: 피규어 size: 420-460, 소품 200-300, 텍스트 70-120, 중간 영역을 바쁘게 유지하고 캡션은 낮게 배치하십시오.

검증 (필수 루프)

  1. stickman check <dir> → 반드시 Check passed를 출력해야 합니다. page_error = JS에서 오류 발생; 수정하십시오.
  2. stickman snapshot <dir> (또는 --at 시간으로 주요 비트 지정) → snapshots/contact-sheet*.jpg 및 PNG 파일을 열고 확인하십시오. 수정: 클리핑, 겹침, 공중에 뜬 피규어, 빈 시간, 읽을 수 없는 텍스트, 팔이 머리를 통과하는 경우(포즈 오버라이드 조정), 잘못된 악센트 색상.
  3. 깔끔해질 때까지 다시 실행한 후 렌더링하십시오.

주의사항

  • 각 피규어를 시간순으로 스케줄하십시오. celebrate()는 +1.0초 후 stand로 돌아오도록 스케줄합니다; 곧 다시 포즈를 취할 경우 { hold: true }를 전달하십시오.
  • bob.hold(prop)는 오른손에 부착되고 똑바로 유지됩니다; 사용 전에 생성하고 .pop(t)하십시오.
  • 텍스트 마크업: "[강조된 단어]"는 accent 옵션(기본값 a2)으로 구문에 색상을 입힙니다.
  • 차트는 이산 단계로 숫자를 셉니다; 차트 옵션에서 prefix/suffix/decimals를 제공하십시오.
  • Math.random/Date/setTimeout을 사용하지 마십시오. SM.rng(seed)를 사용하십시오.
  • 원시 GSAP가 허용됩니다: sc.tl.to(el, vars, sc.T(localTime)) - 시간의 순수 함수로 유지하십시오.

관련 스킬