Communitygithub.com

stick-figure

질문이나 주제를 바탕으로 코드로 애니메이션된 막대인간 설명 릴(9:16, 30~45초)을 제작합니다. 밝은 색상, 두꺼운 윤곽선, 큰 흰색 머리와 표정을 가진 막대인간, 지속적인 카메라 움직임, 채찍 전환, 1~2단어 자막, 장난기 있는 배경음과 효과음이 포함됩니다.

stick-figure란 무엇인가요?

이 스킬은 사용자가 질문이나 주제를 입력하면 완전히 코드로 생성된 9:16 세로형 막대인간 설명 릴(30~45초)을 만듭니다. 릴은 밝고 채도 높은 팔레트, 두꺼운 잉크 윤곽선, 큰 흰색 머리와 다양한 표정을 가진 막대인간, 지속적인 카메라 핸드헬드 드리프트, 모션 블러를 동반한 채찍 전환, 그리고 음성에 맞춰 단어 단위로 나타나는 1~2단어 소문자 자막이 특징입니다. 모든 그래픽(캐릭터, 배경, 소품)은 JavaScript로 그려지며, 음악과 효과음은 Python 코드로 합성됩니다. 이 스킬은 사용자가 `/stick-figure` 명령을 실행하거나 "stick-figure", "stickman", "만약 ~라면" 같은 설명을 요청할 때 사용됩니다. 스킬 폴더에는 완성된 예시 릴이 포함되어 있어 바로 실행하고 학습할 수 있으며, ffmpeg, Node.js, Python 3.9+가 필요합니다. 사용자는 스크립트를 작성하고, 사실을 확인하고, 음성을 생성한 후, 장면을 편집하고, 최종 비디오를 렌더링하는 9단계 워크플로우를 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AyushAggarwal768/claude-animation-skills/tree/HEAD/skills/stick-figure

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

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

문서

/stick-figure

┌──────────────────────┐
│   ☀      ☁           │  밝은 하늘, 바다, 코드로 그려진 소품
│      ◯   ◯           │  큰 흰색 머리와 표정을 가진 막대인간
│     /|\ /|\          │
│     / \ / \  🛢       │
│     안대             │  1~2단어 자막, 소문자, 약 70% 아래쪽
└──────────────────────┘

작업 예제가 함께 제공됩니다: engine/template은 완성된 37초 릴로, "만약 해적 안대가 실명과 관련이 없었다면?"이라는 주제를 다룹니다.

첫 사용

이 스킬의 폴더는 Claude Code가 로드할 때 표시하는 "Base directory"입니다.

SKILL_DIR="<이 스킬의 기본 디렉토리>"
ENGINE="$SKILL_DIR/engine"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
[ -x "$KIT/.venv/bin/python" ] && [ -d "$KIT/models" ] || bash "$KIT/setup.sh" --voice   # 약 1GB 음성 모델, 한 번만
PY="$KIT/.venv/bin/python"; export NODE_PATH="$KIT/node_modules"

ffmpeg, Node 및 Python 3.9+가 필요합니다. 예제를 보려면: cp -r "$ENGINE/template" ~/reels/pirate && bash "$ENGINE/make.sh" ~/reels/pirate.

구성 방식

릴은 하나의 폴더입니다:

  • script.json: 음성 내레이션, 항목당 한 문장.
  • captions.json: 자막의 선택적 텍스트 교체 ({"twenty five": "25"}).
  • web/shots.js: 샷 목록. 각 샷은 SHOTS.push({start, end, tr, draw(ctx, lt, t)}) 형태로 음성 시간(초) 기준입니다. lt는 샷 내 시간, tr은 종료 전환('whip' 또는 'cut').
  • web/lib.js (이징, 키프레임 kf, 도형, 텍스트), web/chars.js (막대인간 리깅 drawStick, 모자, 얼굴, 팔 IK, 안대), web/env.js (하늘, 구름, 바다, 배, 갑판, 통, 대포, 등, 갑판 아래), web/main.js (채찍 블러, 비네트, 그레인, 자막). 새 소품은 env.js 또는 새 env2.js에 추가합니다 (web/index.html에 목록 추가).
  • audio.py: 음악과 SFX, 모두 코드로 합성되며 음성 시간(초) 단위로 배치됩니다.

make.sh는 음성을 생성하고, 모든 단어를 정렬(audio/words_new.json)하고, 사운드를 믹싱하고, 샷을 병렬로 렌더링하여 <폴더>/<폴더 이름>.mp4를 작성합니다.

타이밍: audio/words_ref.json은 샷이 맞춰진 기준 음성입니다. 음성이 변경되어도 단어가 변경되지 않으면 make.sh가 새 테이크에 맞춰 샷을 워프하므로 새 녹음에 편집이 필요 없습니다. 스크립트가 변경되면 audio/words_ref.json을 삭제하고(다음 테이크가 기준이 됨) shots.js의 타이밍을 다시 조정합니다.

단계

  1. 스크립트. 약 110120단어, 3840초 분량, 문장당 하나의 아이디어: "만약 ~라면" 훅, 일반적인 믿음, "하지만"으로 전환, 예시 축적, 메커니즘을 보여주는 하나의 샷, 훅에 답하는 결말. 애니메이션 전에 사용자에게 보여줍니다.
  2. 사실 확인. 출처와 함께 모든 주장을 확인합니다. 이론은 신중하게 표현합니다("과학자들은 생각합니다").
  3. 폴더. cp -r "$ENGINE/template" <릴>을 실행한 후, audio/를 비우고 script.json (그리고 captions.json)을 교체합니다.
  4. 음성. 폴더에서: "$PY" "$ENGINE/tools/tts_kokoro.py" (무료) 또는 사용자 자신의 녹음, 또는 ELEVENLABS_API_KEY를 사용한 ElevenLabs ("$PY" "$ENGINE/tools/tts_elevenlabs.py" audio/vo_el.mp3). 테이크를 audio/vo.wav에 배치한 후, "$PY" "$ENGINE/tools/align.py" audio/vo.wav를 실행하고 audio/words_new.json에서 단어 시간을 읽습니다.
  5. 샷. web/shots.js를 다시 작성: 약 1012개의 셋업, 대부분 24초, 설명 샷은 더 길게. 새로운 아이디어는 새로운 셋업. 훅은 프레임 1에서 바로 액션으로 시작합니다. 얼굴과 주요 소품이 자막 영역(y 약 12501420)과 Instagram의 안전 영역(x 100980, y 220~1500) 안에 들어가도록 유지합니다.
  6. 스틸. 폴더에서: node "$ENGINE/tools/render.js" stills 1.5,4.2,9.0은 stills/에 이미지를 씁니다. 가장 복잡한 순간을 확인하고 전체 렌더링 전에 수정합니다.
  7. 사운드. 단어 시간에 맞춰 audio.py의 큐를 편집합니다.
  8. 빌드. bash "$ENGINE/make.sh" <릴> (audio/vo.wav 유지; kokoro, elevenlabs 또는 파일을 전달하여 교체 가능). 코어가 많은 경우 WORKERS=8 사용. AUDIO_ONLY=1은 다시 렌더링하지 않고 사운드를 리믹스합니다.
  9. 전달 <릴>/<이름>.mp4.

스타일

  • 자막: Poppins Bold, 흰색에 어두운 윤곽선, 1~2단어, 소문자, 구두점 없음(main.js의 capText()가 처리; 숫자와 %는 유지). 화면에 em 대시 없음.
  • 밝고 채도 높은 팔레트, 잉크 윤곽선(#221c22), 부드러운 접촉 그림자, 핸드헬드 드리프트가 있는 느린 푸시인, 모션 블러가 있는 채찍 전환. 충격은 폭발, 흔들림, 섬광으로 표현.
  • SFX는 음성 아래에 위치(게인 약 0.38). 음악은 조용히 퉁기는 배경음으로, 음성 아래에서 덕킹되며, 처음부터 큰 루프 없음.

관련 스킬