艺术动画skill：35种艺术风格、9种解说语法，用代码让画动起来。

huashu‑art‑motion – 코드 기반 예술적 애니메이션

정의 – 코딩 에이전트가 다양한 예술적 스타일로 짧고 프레임 정확한 애니메이션 클립을 생성할 수 있게 해주는 코드, 데이터, 도구 모음입니다. 이 저장소는 다음을 포함합니다:

구성 요소	제공 내용
35가지 스타일 "레시피 카드"	동굴 벽화부터 반 고흐, 바우하우스, 8비트, 베이퍼웨이브 등 스타일의 매개변수 세트, 모션 모티프, 전환 정의.
엔진 및 라이브러리	브러시, 렌더러, 후처리, 카메라 헬퍼, 오디오 합성 템플릿 등을 갖춘 자체 포함 애니메이션 엔진(`scripts/engine/`).
장면 스크립트	각 스타일당 하나의 실행 가능한 장면(`scripts/engine/scenes/`).
설명 비디오 문법	내레이션 사양을 시간이 지정된 클립에 매핑하는 9개의 JSON 기반 "문법" 템플릿(Kurzgesagt, Vox, 화이트보드, 스토리타임, 키네틱 타이포, 3Blue1Brown, 키노트 UI, 파이낸스 차트, 프레젠터).
긴 스크롤 데모	캐릭터가 연속된 그림을 걷는 스켈레톤으로, 세 가지 샘플 세계(이집트 벽화 → 모네 → 8비트)가 있습니다.
유틸리티 스크립트	`breakdown.py`(참조 비디오를 컷 그리드 + 모션 히트맵으로 변환), `qa.py`(자동 품질 지표), 오디오 생성 헬퍼, 폰트 서브셋 등.
문서	12개의 방법 가이드 마크다운 파일, 스타일 카드 마크다운, 문법 사양, 코딩 에이전트가 올바른 문서를 선택하는 방법을 설명하는 `SKILL.md`.

작동 방식(높은 수준)

스타일 선택 – 35개의 레시피 카드 중 하나를 선택합니다. 각 카드는 브러시 설정, 색상 팔레트, 시그니처 전환, 단편 영화 "템플릿"을 정의합니다.
사양 작성 – 설명 비디오 문법의 경우 내레이션 줄, 타이밍, 선택적 자산(예: 캐릭터 이미지)을 나열하는 JSON을 제공합니다. 엔진은 사양을 프레임 정확한 타임라인으로 변환합니다.
렌더링 – 제공된 Python 진입점(scripts/engine/render.py)을 선택한 장면 또는 문법으로 실행합니다. 스크립트는 종속성 관리에 uv, 비디오 인코딩에 ffmpeg, 헤드리스 캔버스 렌더링에 Playwright Chromium을 사용합니다.
QA – 렌더링 후 qa.py는 안정성, 프레임당 비용, 모션 부드러움, 텍스트 오버레이 일관성을 평가합니다. 별도의 에이전트가 출력을 검증하기 위해 실행할 수 있습니다.
합성 – 생성된 MP4(또는 알파가 있는 PNG 시퀀스)는 함께 이어붙이거나, 내레이션 파이프라인에 추가하거나, 더 큰 프로덕션의 시각적 요소로 사용할 수 있습니다.

빠른 시작(빠른 단계)

# 1. 클론 및 종속성 설치
 git clone https://github.com/alchaincyf/huashu-art-motion.git
 cd huashu-art-motion
 uv sync   # uv, ffmpeg, playwright 등을 설치
 uv run --with playwright playwright install chromium

# 2. 반 고흐 스타일의 단일 프레임 렌더링
 uv run --with playwright python scripts/engine/render.py \
     --solo 09_postimp --stills 0.3 --out demo_van_gogh.png

# 3. 전체 설명 클립 렌더링(파이낸스 차트 문법)
 uv run --with playwright python scripts/engine/render.py \
     --spec scripts/engine/examples/t3_finance_chart.json \
     --out finance_chart.mp4

--solo 플래그는 장면을 선택합니다. --spec은 문법 JSON을 가리킵니다.

누가 사용할 수 있나요?

콘텐츠 제작자: YouTube 설명 비디오를 위해 프로그래밍 방식으로 스타일 일관된 애니메이션을 원하는 분.
AI 에이전트(예: Claude, GPT‑4o): *"캔버스를 걷는 고양이를 위한 5초 반 고흐 전환 만들기"*와 같은 작업을 받고 적절한 레시피와 렌더링 스크립트를 호출할 수 있습니다.
연구자: 절차적 아트 생성, 스타일 전이 파이프라인, 자동 비디오 QA를 탐구하는 분.
교육자: 코드가 미술사 시대를 넘어 시각적 스토리텔링을 구동하는 방법을 보여주는 분.

제한 사항 및 범위

저장소는 코드와 데이터만 제공합니다. 내레이션 오디오나 사용자 정의 캐릭터 자산은 직접 제공해야 합니다.
렌더링은 헤드리스 Chromium 캔버스에 의존합니다. 성능은 하드웨어에 따라 다릅니다.
아홉 번째 "프레젠터" 문법은 참조 구현이며 자체 캐릭터 프레임을 제공해야 합니다.

라이선스

핵심 코드 및 문서: MIT(자유롭게 수정 및 재배포 가능).
글꼴: 다양한 SIL OFL 라이선스.
스트로크 데이터: Arphic Public License.
저자의 만화 아바타 및 데모 비디오 이미지는 데모 전용이며 MIT 라이선스에 포함되지 않습니다.

TL;DR

huashu-art-motion은 코딩 에이전트의 높은 수준의 설명을 35가지 예술적 스타일의 애니메이션 클립으로 변환하는 스킬 패키지로, 기성 장면 스크립트, 스타일 레시피, 설명 비디오 문법을 갖추고 있습니다. 생성 예술, 절차적 애니메이션, AI 기반 콘텐츠 파이프라인의 교차점에 있는 진정한 코드 중심 프로젝트입니다.

alchaincyf/huashu-art-motion