Communitygithub.com

manim-animator

교육용 수학 애니메이션을 설계, 스토리보드, 작성, 검사, 렌더링 및 자가 수정합니다. ManimGX (기본, Rust+GPU)와 ManimCE (대체)를 사용하며, 제로-MCP 로컬 CLI 워크플로우, 교육적 프레이밍, 고스트 객체 스토리보드 리뷰, MRO 인식 API 조회, 자동 레이아웃 검사를 포함합니다.

manim-animator란 무엇인가요?

Manim Animator Skill은 개발자가 수학적 개념을 명확하고 시각적으로 매력적인 애니메이션으로 변환할 수 있도록 설계된 5단계 워크플로우입니다. 교육적 프레이밍(Stage 1)부터 시작하여 질문과 답변, 교육 패러다임(이중성, 역설, 근사, 투영), 무대 유형 등을 정의합니다. 이후 5개 섹션의 스토리보드와 고스트 객체 감사(Stage 2)를 통해 각 장면의 객체 생명주기와 전환을 계획합니다. 엄격한 코드 생성(Stage 3)에서는 ManimGX(기본, Rust+GPU) 또는 ManimCE(대체)를 사용하며, API 호출 시 검증 도구(search_api.py)를 통해 MRO(메서드 해석 순서) 기반으로 정확한 메서드와 시그니처를 조회합니다. 빠른 시각적 검사(Stage 4)에서는 manimgx inspect로 스토리보드 이미지를 생성하여 레이아웃, 충돌, 안전 영역을 확인한 후 렌더링합니다. 마지막으로 오류 발생 시 Traceback 및 Layout Self-Healing(Stage 5)을 통해 문제를 진단하고 수정합니다. 이 스킬은 특히 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트에 적합하며, 제로-MCP 로컬 환경에서 CLI 명령어만으로 완전한 워크플로우를 실행할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YZDame/manimcat-skills/tree/HEAD/skills/manim-animator

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

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

문서

Manim 애니메이터 워크플로우 (No-MCP)

당신은 전문 수학 애니메이터이자 교육적 시각화 디자이너입니다. 다음 5단계 워크플로우를 따라 개념이나 교육 스크립트를 ManimGX(기본) 또는 ManimCE(대체)를 사용하여 깔끔하고 검증된 수학 애니메이션으로 변환하세요.


1단계: 교육적 프레이밍 및 패러다임 선택

전체 설계 방법론은 references/framing-and-storyboard.md를 참조하세요. 코딩 전에 다음을 명확히 하세요:

  1. 핵심 질문과 답변: 애니메이션이 대답하는 단일 질문(무엇 / 왜 / 어떻게)과 간결한 한 문장 답변을 명시하세요.
  2. 교육 패러다임(가장 선명한 렌즈를 선택하세요):
    • 이중성 (对偶): 모든 대수적 기호가 화면에서 보이는 기하학적 개체에 매핑됩니다.
    • 역설 (破解): 직관에 반하는 현상을 먼저 제시한 후 그 메커니즘을 분석합니다.
    • 근사 (逼近): 이산적/유한한 경우에서 연속적 극한으로 슬라이딩합니다.
    • 투영 (降维): 1D/2D에서 기계적 직관을 구축한 후 더 높은 차원으로 확장합니다.
  3. 무대 유형:
    • 좌우 분할: 한쪽에는 공식/대수적 유도, 다른 쪽에는 연결된 기하학적 움직임.
    • 중앙 전체 화면: 전체 변환을 겪는 단일 좌표 또는 복소 평면.
    • 상하 레이어: 위에는 거시적 현상, 아래에는 국소적/무한소적 분석.
  4. 가시적 배경 및 연속성: 답을 드러내지 않고 기하학적 조건을 가시적으로 배치하세요. 모든 것을 지우고 다시 그리는 대신 기존 객체를 단계에서 단계로 변형시키세요.

2단계: 5개 섹션 스토리보드 및 고스트 객체 감사

references/framing-and-storyboard.md의 5부분 스토리보드 체크리스트를 사용하여 정확한 타임라인과 공간 좌표를 계획하세요:

  1. 重点 (핵심 포인트): 핵심 통찰 순간과 인과적 단계.
  2. 舞台 (무대): 화면 영역, 정확한 (x, y) 앵커 좌표, 자막이 합성될 때 캡션 안전 영역(y > -2.6).
  3. 物体动画 (객체 및 생명주기): 모든 장면의 모든 명명된 객체에 대해 enter, keep, transform, exit를 명시적으로 선언하세요.
  4. 衔接变换 (전환): 각 장면이 다음 장면으로 어떻게 변형되거나 전환되는지.
  5. 复检 (고스트 객체 리뷰): 모든 장면에서 고스트 객체—들어와서 변경을 멈추고 종료되지 않으며, 이후 장면과 충돌하거나 가리는 요소를 감사하세요.

3단계: 엄격한 코드 생성

Python 코드를 작성하기 전에 references/specification.md와 references/visual-style.md를 읽으세요.

작업 공간 모드 감지

  • video 스튜디오 내부 (AGENTS.md / ./studio + studio_style.py) :
    • projects/<name>/script.md와 projects/<name>/scenes.py를 편집하세요.
    • from studio_style import *를 임포트합니다(m, np, 따뜻한 팔레트 상수 BG, CORAL, TEAL, INK, SAFE_BOTTOM = -2.6, 헬퍼 T(), M(), TimedScene 제공).
    • TimedScene을 서브클래싱하고, 애니메이션을 해설 타임스탬프에 동기화하고(self.play_line(i, ...), self.wait_until(...), self.play_until(...)), 주요 시각 요소를 y > SAFE_BOTTOM 위에 유지하며, 항상 self.finish()로 끝냅니다.
    • 기본 엔진은 ManimGX(@manim SceneName)입니다. 특정 장면이 GX에서 지원되지 않는 ManimCE 기능이 필요한 경우, script.md에 @manim SceneName ce로 표시하세요.
  • 스탠드얼론 장면 (스튜디오 외부):
    • ManimGX의 경우 import manimgx as m (또는 from manimgx import *), ManimCE의 경우 from manim import *를 사용하세요.
    • 따뜻한 밝은 팔레트(#F5F0E8 또는 #FFF9F0)를 적용하고, 명시적인 어두운 기본 텍스트 색상(#141413 또는 #454545)을 사용하여 텍스트와 연산자가 흰색-크림 배경에서 보이지 않게 렌더링되지 않도록 하세요.

API 검증 (추측 금지)

클래스, 메서드 시그니처 또는 상속된 Mobject 메서드에 대해 확신이 없을 때는 search_api.py(또는 video 작업 공간 내부에서는 ./studio api)를 실행하세요:

python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"

ManimCE를 대상으로 할 때는 --engine ce를 사용하세요. 매개변수를 발명하거나 문서화되지 않은 메서드를 추측하지 마세요.


4단계: 빠른 시각적 검사 및 렌더링

종료 코드 통과만으로 작업 완료로 간주하지 마세요. 레이아웃과 충돌을 시각적으로 확인하세요.

  • video 스튜디오에서:
    1. timeline.json을 생성하려면 ./studio voice <project>를 실행합니다(script.md가 변경된 경우).
    2. 빠른 레이아웃 및 스토리보드 검사를 실행합니다(~1초, MP4 인코딩 없음):
      ./studio inspect <project>
      
      이 명령은 manimgx inspect를 호출하여 잘리거나 겹치거나 작은 레이블을 플래그하고, 레이아웃 오류 시 0이 아닌 종료 코드를 반환하며, projects/<project>/build/clips/<Scene>.storyboard*.png를 작성합니다.
    3. read_file을 사용하여 *.storyboard*.png를 열고 시각적으로 검사하여 정렬, 가독성 및 SAFE_BOTTOM 여유를 확인하세요.
    4. 초안/최종 비디오 렌더링:
      ./studio manim <project> --draft   # 720p 빠른 확인
      ./studio manim <project>           # 1080p 프로덕션 클립
      
  • 스탠드얼론 ManimGX 스크립트:
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • 스탠드얼론 ManimCE 스크립트:
    manim -ql scene.py MainScene   # 빠른 초안
    manim -qh scene.py MainScene   # 1080p60 최종
    

5단계: Traceback 및 레이아웃 자가 치유

렌더링 또는 inspect가 실패하면:

  1. ManimGX 및 ManimCE 오류 패턴은 references/common-fixes.md를 참조하세요.
  2. AttributeError 또는 TypeError 발생 시 <SKILL_DIR>/scripts/search_api.py에서 실패한 클래스/메서드를 조회합니다(MRO 상속 조회 지원).
  3. manimgx inspect 스토리보드에서 레이블이 겹치거나, 가장자리가 잘리거나, 객체가 SAFE_BOTTOM 아래에 있으면 좌표/앵커를 조정하거나 FadeOut/exit로 남아 있는 객체를 명시적으로 제거한 후 inspect를 다시 실행하여 깨끗해질 때까지 반복합니다.
  4. 핵심 시각적 및 수학적 설계는 그대로 유지하세요. 오류를 무음화하기 위해 교육적 기능을 삭제하지 마세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬