Communitygithub.com

모션 툴 및 스킬

수채화 잉크 스타일의 애니메이션 비디오(MP4)를 코드로 제작하는 방법 — p5.js + p5.brush를 헤드리스 Chrome에서 프레임별로 렌더링하고 ffmpeg으로 인코딩 — Clawd 또는 어떤 캐릭터도 출연 가능합니다.

모션 툴 및 스킬란 무엇인가요?

이 스킬은 개발자가 순수 코드만으로 핸드메이드 수채화-잉크 스타일의 카툰 비디오를 제작할 수 있게 해줍니다. p5.js와 p5.brush 라이브러리를 활용해 1920×1080 해상도의 각 프레임을 시간 `t`의 순수 함수로 그리고, headless Chrome으로 병렬 렌더링한 후 ffmpeg으로 MP4로 인코딩합니다. 음악/가사 비디오, 애니메이션 GIF, 쇼트 필름 등에 적합하며, 기본 캐릭터 Clawd와 함께 다양한 캐릭터, 소품, 감정 표현을 지원합니다. 스토리보드 작성부터 프레임별 검토, 최종 렌더링까지 전체 워크플로를 포함하며, 특히 '무엇이 일어나는가(reads)'를 기준으로 한 샷 설계와 수채화/잉크 브러시만 사용하는 '핸드메이드 룩'이 핵심입니다. 긴 영상은 여러 하위 에이전트로 분할하여 병렬 처리할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/painted-animation

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

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

문서

페인티드 애니메이션

완전히 코드로 짧은 카툰을 만드는 방법으로, JohnHeibel/PDoomVideo (Claude Opus가 그린 156초 뮤직비디오)와 이를 일반화한 키트 ClaudeAnimationBase (MIT)에서 정제되었으며, template/에 번들로 포함되어 있습니다.

작동 방식: 모든 프레임은 시간 t의 순수 함수입니다. studio.html이 p5.js + p5.brush와 여러분의 씬 파일을 로드합니다. 각 샷은 1920×1080 프레임 전체를 수채화 채움과 끓어오르는 잉크 선으로 그립니다. render.mjs는 headless Chrome을 구동하여 리뷰용 콘택트 시트 또는 모든 프레임을 병렬로 렌더링하고, ffmpeg이 MP4(오디오 포함 가능)를 인코딩합니다.

워크플로

0. 스캐폴드

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir>        # --keep-demo를 추가하면 예제 씬을 연결한 상태로 유지

이 명령은 템플릿을 복사하고, 데모 씬을 해제하며, npm install을 실행하고 node / ffmpeg / Chrome을 확인합니다. 그런 다음 <project-dir>/ANIMATION_GUIDE.md를 전체 읽기를 한 후 무엇이든 설계하십시오: 가이드에는 규칙, 애니메이션 원칙 및 완전한 엔진/Clawd API가 담겨 있습니다. Read 도구로 docs/emotions.jpg와 docs/views.jpg(모델 시트)를 살펴보십시오.

뮤직비디오나 20초 이상의 영상이라면 references/music-video.md도 읽으십시오. 가사 비디오의 경우 먼저 노래 파일과 LRC를 요청하고 scripts/beat_grid.py로 템포를 측정하십시오: 라인은 보통 예상보다 빠릅니다.

1. 코드보다 먼저 스토리보드

프로젝트에 STORYBOARD.md를 작성하십시오 (가이드에 있는 형식: 로그라인, 세계 + 팔레트 아크, 모티프, 캐릭터 감정 아크, 그 다음 reads가 포함된 샷들 — 시청자가 이해해야 할 타이밍 목록). 작업 예시: examples/xiaozhen/ (31초 가사 비디오: 스토리보드 및 전체 씬 코드).

사용자가 그냥 진행하라고 하지 않는 이상, 빌드하기 전에 스토리보드를 사용자에게 보여주고 반응을 받으십시오.

2. 샷별로 빌드

  • src/config.js에서 duration, bpm, offset (및 audio)을 설정하십시오.
  • src/scenes/에 씬/챕터당 하나의 IIFE로 감싼 파일을 만들고, shots([[t0, fn], ...])로 끝내십시오. 해당 <script>를 studio.html에 추가하십시오.
  • 먼저 키 포즈를 블로킹하고, 정지 이미지로 확인한 다음 그 사이의 모션을 추가하십시오.

3. 렌더링하고 살펴보기 — 모든 샷, 여러 번

코드를 읽는 것만으로는 모션을 볼 수 없습니다. 프로젝트 디렉터리에서:

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # 키 프레임
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # 한 순간의 모든 프레임
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # 풀-해상도 디테일

각 이미지를 Read로 열고 가이드의 리뷰 목록에 따라 실제로 확인하십시오: 이벤트가 명확한가? 캐릭터가 충분히 큰가? first-time 시청자가 이해할 수 있도록 reads의 타이밍이 맞는가? 예비 동작/후속 동작이 있는가, 스냅이 없는가? 발과 잡고 있는 소품이 바닥에 닿는가? 모든 이음새에 트랜지션이 있는가? 텍스트, 3D, 순수 검정/흰색, 뿌연 글로우가 없는가? 수정하고 다시 확인하십시오. 예산: 샷당 최소 1장의 시트, 주요 모션과 트랜지션당 1개의 스트립, 스토리를 전달하는 얼굴당 1개의 크롭.

4. 비디오 렌더링

node render.mjs --clip --out=out/video.mp4                                   # 짧은 비디오, 워커 1개
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # 긴 비디오, 병렬 + 재개 가능

출력 경로, 길이 및 ms/프레임을 보고하십시오. open out/video.mp4를 제공하십시오.

가장 중요한 규칙

다음은 가이드의 규칙을 요약한 것입니다. 가이드가 권위를 가집니다.

  1. 핸드메이드 매체. paint() / inkLine() (p5.brush)만 사용 — 절대 일반 p5 rect/ellipse/fill을 사용하지 마십시오. 평면 2D만: 회전은 그려진 키 뷰(turn(), spinView())를 통해 이루어지며, 절대 3D 투영을 사용하지 않습니다. glow()(가산 혼합)로 조명 처리 — 안료 혼합은 노란색 위에 파란색이 녹색이 되기 때문입니다.
  2. 텍스트 없음. 자막, 라벨, 표지판, 말풍선 없음; 대신 보여주십시오. 반응은 그려진 이모트(!, 땀, 하트…)로 표현합니다. 유일한 예외는 가사 비디오의 가라오케와 최대 몇 개의 큰 SFX입니다.
  3. 모든 샷에서 무언가 일어납니다 — 이벤트, 원인 → 반응, 설정된 장치가 결실을 맺습니다.
  4. 시청자를 위한 시간. 각 샷의 reads를 나열하십시오; 한 번에 하나의 read; 빠른 액션, 유지된 의미; 시선을 유도하십시오; reads가 샷 길이를 결정합니다. 이것이 생성형 애니메이션이 가장 실패하는 지점입니다.
  5. 살아있음. 아무것도 정지해 있지 않습니다(feel()의 idle, 떠다니는 카메라, boil); 얼굴은 교체가 아니라 emotions()를 통해 변화합니다; 캐릭터는 큽니다(미디엄 샷 u≈20–28, 클로즈업 40–70); 모든 것이 비트를 탑니다.
  6. 모든 이음새에 트랜지션이 있으며, 이야기에 맞게 선택합니다(브러시 와이프, 아이리스 / 모양 아이리스, 채찍 팬, 매치 컷, 액션 컷, 카메라 캐리 스루).
  7. 하나의 작품. 하나의 세계, 색상 아크, 감정적 실, 연결된 씬, 오프닝과 운율이 맞는 엔딩.

엔진 주의사항

  • t의 순수 함수. 프레임은 병렬로, 순서 없이 렌더링됩니다: 프레임 간 상태 없음, Math.random() 없음, 프레임별 물리 없음. 안정적인 난수는 hash(i), boil은 jit()을 사용하십시오.
  • 각각의 배경 요소/소품 앞에 **boilSeed(key)**를 호출하십시오. 그렇지 않으면 움직이는 요소가 그 뒤에 그려진 모든 것을 매 프레임마다 다시 끓게 만듭니다(지터).
  • p5의 전역 변수 이름을 사용하지 마십시오. p5는 line, OVERLAY, text, color, scale, …을 전역으로 정의합니다; 최상위 function line()은 Cannot redefine property 오류로 실패하고 페이지가 준비되지 않습니다(렌더러가 타임아웃됨). 헬퍼를 씬 IIFE 내부에 두거나 구별되는 이름을 사용하십시오.
  • 문, 창문, 화면의 레이어링: 내부에 있는 것을 그린 다음, 주변 벽/프레임을 다시 덧칠하여 개구부보다 넓은 것이 외부로 보이지 않게 하십시오(기차의 inDoor + 문틀, TV 베젤 조각).
  • 점 목록의 NaN은 Failed to construct 'OffscreenCanvas' 오류를 발생시킵니다 — 변형된 지오메트리를 방지하십시오.
  • 카메라 줌 2배 이상에서 큰 도형은 외곽선이 사라집니다. 외곽선 두께는 줌에 비례하므로 클로즈업에서는 sw를 줄이십시오.
  • 비용 = 채움(fill)과 선(stroke)의 개수입니다. 약 ≤1.5–2.5 s/프레임을 목표로 하십시오 (로그에 ms/프레임이 출력됩니다). 더 적고 더 큰 도형을 선호하십시오. 실제 GPU가 없는 머신에서는 수채화 채움이 느리므로, fill 도형 수를 줄이거나 최후의 수단으로 --soft-gl을 고려하십시오.
  • macOS: 렌더러는 --use-angle=metal을 사용하고 /Applications/Google Chrome.app을 자동으로 찾습니다. 그렇지 않으면 --chrome=<path>를 전달하십시오.

적응

  • Clawd는 기본 스타이지 필수는 아닙니다. 새 캐릭터, 소품, 감정은 동일한 도구(paint, ribbon, through, glow)로 그려지며 샷 전체에서 일관성을 유지합니다. 새 감정은 src/clawd.js의 EMO에 추가됩니다.
  • src/karaoke.js (템플릿)는 core.js의 window.overlayHook 훅을 통해 가사 비디오용 단어별 가라오케를 추가합니다.
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png는 GIF용 무한 루프를 만듭니다 (ffmpeg -i out/loop_name/f%04d.png …).
  • 더 높은 추론 노력은 일반적으로 더 화려하고 상세한 씬을 생성합니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

VisualxIntelligence/motion-tools-and-skills

Make kinetic-typography motion reels (MP4) in code: showreels, portfolio or work reels, product promos, intro films, "motion design"-style videos with bold condensed type, HUD micro-type, black/cream/lime palette, three.js generative layers (particle terrain, liquid marble, chrome knot, particle clouds), shape-continuity transitions and a synthesized, beat-locked score. Canvas 2D + WebGL rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when the user asks for a reel, showreel, motion-graphics / kinetic-type video, a "Work Reel" in this style, or to extend/re-cut the Work Reel ’26.

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

관련 스킬