Communitygithub.com

Syammon02/VideoUse

Manim 커뮤니티 에디션을 사용한 수학 및 기술 애니메이션 제작 파이프라인입니다. 3Blue1Brown 스타일의 설명 영상, 알고리즘 시각화, 수식 유도, 아키텍처 다이어그램, 데이터 스토리를 제작합니다. 사용자가 애니메이션 설명, 수학 애니메이션, 개념 시각화, 알고리즘 워크스루, 기술 설명, 3Blue1Brown 스타일 영상, 또는 기하학/수학 콘텐츠를 포함한 프로그래매틱 애니메이션을 요청할 때 사용하세요.

VideoUse란 무엇인가요?

이 스킬은 Manim Community Edition을 활용하여 교육용 수학 및 기술 애니메이션 영상을 제작하는 완전한 파이프라인을 제공합니다. 3Blue1Brown 스타일의 고품질 설명 영상, 알고리즘 시각화, 수식 유도, 아키텍처 다이어그램, 데이터 스토리 등 다양한 모드를 지원합니다. 사용자는 단일 Python 스크립트로 장면을 계획(plan.md), 코딩(script.py), 렌더링(manim -ql/-qh), ffmpeg으로 스티칭, 음성 해설 추가까지의 전체 워크플로우를 따릅니다. 주요 특징으로는 통일된 색상 팔레트(클래식 3B1B, 웜 아카데믹, 네온 테크, 모노크롬), 모노스페이스 폰트 강제 사용, 장면별 시각적 변주(색상, 레이아웃, 애니메이션 진입 방식), 그리고 각 애니메이션 후 적절한 대기 시간을 통한 학습 속도 배려가 있습니다. 성능 목표는 -ql(초안, 854x480@15fps)부터 -qh(프로덕션, 1920x1080@60fps)까지이며, 초안에서 반복 작업 후 최종 출력에서만 고품질 렌더링을 권장합니다. 또한 사용자가 실험적/창의적인 출력을 요청할 경우 SCAMPER 기법이나 가정 뒤집기(Assumption Reversal) 같은 창의적 발상 전략을 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Syammon02/VideoUse/tree/HEAD/skills/manim-video

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

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

문서

Manim 영상 제작 파이프라인

창작 기준

이것은 교육용 영화입니다. 모든 프레임이 가르치고, 모든 애니메이션이 구조를 드러냅니다.

단 한 줄의 코드를 작성하기 전에, 이야기 흐름을 명확히 하세요. 이 영상이 교정하려는 오개념은 무엇인가요? '아하 순간'은 무엇인가요? 시청자를 혼란에서 이해로 이끄는 시각적 이야기는 무엇인가요? 사용자의 프롬프트는 시작점일 뿐입니다 — 교육적 야망을 가지고 해석하세요.

대수보다 기하를 먼저. 모양을 먼저 보여주고, 방정식은 나중에 보여주세요. 시각적 기억은 기호적 기억보다 더 빨리 인코딩됩니다. 시청자가 공식보다 기하학적 패턴을 먼저 보면, 방정식은 자연스럽게 느껴집니다.

첫 렌더링에서의 완성도는 타협할 수 없습니다. 출력물은 수정 없이 시각적으로 명확하고 미학적으로 일관되어야 합니다. 만약 무언가 어수선하거나, 타이밍이 나쁘거나, 'AI가 만든 슬라이드'처럼 보인다면 잘못된 것입니다.

불투명도 계층화로 주의를 유도하세요. 모든 것을 최대 밝기로 보여주지 마세요. 주요 요소는 1.0, 맥락 요소는 0.4, 구조 요소(축, 격자)는 0.15로 설정하세요. 뇌는 시각적 현저성을 계층적으로 처리합니다.

숨 고르기. 모든 애니메이션 후에는 self.wait()이 필요합니다. 시청자는 방금 나타난 것을 흡수할 시간이 필요합니다. 절대 한 애니메이션에서 다음 애니메이션으로 서두르지 마세요. 핵심 장면 후 2초의 멈춤은 결코 낭비가 아닙니다.

일관된 시각적 언어. 모든 장면은 공통된 색상 팔레트, 일관된 타이포그래피 크기, 일치하는 애니메이션 속도를 공유해야 합니다. 모든 장면이 무작위로 다른 색상을 사용하는 기술적으로 정확한 영상은 미학적 실패입니다.

전제 조건

scripts/setup.sh를 실행하여 모든 의존성을 확인하세요. 필요 사항: Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (리눅스에서는 texlive-full, macOS에서는 mactex), ffmpeg. 참조 문서는 Manim CE v0.20.1 기준으로 테스트되었습니다.

모드

모드입력출력참조
개념 설명주제/개념기하학적 직관을 갖춘 애니메이션 설명references/scene-planning.md
수식 유도수학 표현식단계별 애니메이션 증명references/equations.md
알고리즘 시각화알고리즘 설명데이터 구조와 함께하는 단계별 실행references/graphs-and-data.md
데이터 스토리데이터/지표애니메이션 차트, 비교, 카운터references/graphs-and-data.md
아키텍처 다이어그램시스템 설명연결과 함께 구축되는 구성 요소references/mobjects.md
논문 설명연구 논문주요 발견 및 방법을 애니메이션화references/scene-planning.md
3D 시각화3D 개념회전하는 표면, 매개변수 곡선, 공간 기하학references/camera-and-3d.md

스택

프로젝트당 단일 Python 스크립트. 브라우저, Node.js, GPU가 필요하지 않습니다.

계층도구목적
핵심Manim Community Edition장면 렌더링, 애니메이션 엔진
수학LaTeX (texlive/MiKTeX)MathTex를 통한 수식 렌더링
비디오 I/Offmpeg장면 스티칭, 형식 변환, 오디오 먹싱
TTSElevenLabs / Qwen3-TTS (선택 사항)나레이션 음성

파이프라인

계획 --> 코딩 --> 렌더링 --> 스티칭 --> 오디오 (선택 사항) --> 검토
  1. 계획 — 이야기 흐름, 장면 목록, 시각적 요소, 색상 팔레트, 음성 해설 대본을 포함한 plan.md 작성
  2. 코딩 — 장면당 하나의 클래스로, 각각 독립적으로 렌더링 가능한 script.py 작성
  3. 렌더링 — 초안은 manim -ql script.py Scene1 Scene2 ..., 프로덕션은 -qh
  4. 스티칭 — ffmpeg로 장면 클립을 연결하여 final.mp4 생성
  5. 오디오 (선택 사항) — ffmpeg를 통해 음성 해설 및/또는 배경 음악 추가. references/rendering.md 참조
  6. 검토 — 미리보기 스틸 렌더링, 계획과 비교 확인, 조정

프로젝트 구조

project-name/
  plan.md                # 이야기 흐름, 장면 분석
  script.py              # 모든 장면을 하나의 파일에
  concat.txt             # ffmpeg 장면 목록
  final.mp4              # 스티칭된 출력
  media/                 # Manim이 자동 생성
    videos/script/480p15/

창작 방향

색상 팔레트

팔레트배경색주색보조색강조색사용 사례
클래식 3B1B#1C1C1C#58C4DD (BLUE)#83C167 (GREEN)#FFFF00 (YELLOW)일반 수학/CS
웜 아카데믹#2D2B55#FF6B6B#FFD93D#6BCB77친근한 느낌
네온 테크#0A0A0A#00F5FF#FF00FF#39FF14시스템, 아키텍처
모노크롬#1A1A2E#EAEAEA#888888#FFFFFF미니멀리스트

애니메이션 속도

맥락run_time이후 self.wait()
제목/도입부 등장1.5초1.0초
핵심 수식 공개2.0초2.0초
변환/모핑1.5초1.5초
보조 레이블0.8초0.5초
FadeOut 정리0.5초0.3초
'아하 순간' 공개2.5초3.0초

타이포그래피 스케일

역할글꼴 크기사용법
제목48장면 제목, 시작 텍스트
헤딩36장면 내 섹션 헤더
본문30설명 텍스트
레이블24주석, 축 레이블
캡션20자막, 세부 사항

글꼴

모든 텍스트에는 모노스페이스 글꼴을 사용하세요. Manim의 Pango 렌더러는 모든 크기에서 비례 글꼴의 커닝이 깨집니다. 전체 권장 사항은 references/visual-design.md를 참조하세요.

MONO = "Menlo"  # 파일 상단에 한 번 정의

Text("Fourier Series", font_size=48, font=MONO, weight=BOLD)  # 제목
Text("n=1: sin(x)", font_size=20, font=MONO)                  # 레이블
MathTex(r"\nabla L")                                            # 수학 (LaTeX 사용)

가독성을 위해 최소 font_size=18을 사용하세요.

장면별 변주

모든 장면에 동일한 구성을 사용하지 마세요. 각 장면마다:

  • 팔레트에서 다른 주색 사용
  • 다른 레이아웃 — 항상 모든 것을 중앙에 배치하지 않음
  • 다른 애니메이션 진입 방식 — Write, FadeIn, GrowFromCenter, Create 등 다양하게
  • 다른 시각적 무게 — 일부 장면은 조밀하게, 다른 장면은 여백을 많이

워크플로우

1단계: 계획 (plan.md)

코드 작성 전에 plan.md를 작성하세요. 전체 템플릿은 references/scene-planning.md를 참조하세요.

2단계: 코딩 (script.py)

장면당 하나의 클래스. 모든 장면은 독립적으로 렌더링 가능해야 합니다.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Scene1_Introduction(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Why Does This Work?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Why does this work?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

핵심 패턴:

  • 모든 애니메이션에 자막: self.add_subcaption("text", duration=N) 또는 self.play() 내 subcaption="text"
  • 장면 간 일관성을 위해 파일 상단에 공유 색상 상수
  • 모든 장면에서 self.camera.background_color 설정
  • 깔끔한 종료 — 장면 끝에서 모든 mobject를 FadeOut: self.play(FadeOut(Group(*self.mobjects)))

3단계: 렌더링

manim -ql script.py Scene1_Introduction Scene2_CoreConcept  # 초안
manim -qh script.py Scene1_Introduction Scene2_CoreConcept  # 프로덕션

4단계: 스티칭

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

5단계: 검토

manim -ql --format=png -s script.py Scene2_CoreConcept  # 미리보기 스틸

중요 구현 참고 사항

LaTeX용 Raw 문자열

# 잘못된 예: MathTex("\frac{1}{2}")
# 올바른 예:
MathTex(r"\frac{1}{2}")

가장자리 텍스트는 buff >= 0.5

label.to_edge(DOWN, buff=0.5)  # 절대 0.5 미만으로 설정하지 않음

텍스트 교체 전 FadeOut

self.play(ReplacementTransform(note1, note2))  # note2 위에 Write(note2)를 하지 않음

추가되지 않은 Mobject를 애니메이션하지 않음

self.play(Create(circle))  # 먼저 추가해야 함
self.play(circle.animate.set_color(RED))  # 그 다음 애니메이션

성능 목표

품질해상도FPS속도
-ql (초안)854x48015장면당 5-15초
-qm (중간)1280x72030장면당 15-60초
-qh (프로덕션)1920x108060장면당 30-120초

항상 -ql로 반복 작업하세요. 최종 출력에만 -qh로 렌더링하세요.

참조 문서

파일내용
references/animations.md핵심 애니메이션, 속도 함수, 구성, .animate 문법, 타이밍 패턴
references/mobjects.md텍스트, 도형, VGroup/Group, 위치 지정, 스타일링, 사용자 정의 mobject
references/visual-design.md12가지 디자인 원칙, 불투명도 계층화, 레이아웃 템플릿, 색상 팔레트
references/equations.mdManim에서의 LaTeX, TransformMatchingTex, 유도 패턴
references/graphs-and-data.md축, 플로팅, BarChart, 애니메이션 데이터, 알고리즘 시각화
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, 3D 표면, 카메라 제어
references/scene-planning.md이야기 흐름, 레이아웃 템플릿, 장면 전환, 계획 템플릿
references/rendering.mdCLI 참조, 품질 사전 설정, ffmpeg, 음성 해설 워크플로우, GIF 내보내기
references/troubleshooting.mdLaTeX 오류, 애니메이션 오류, 일반적인 실수, 디버깅
references/animation-design-thinking.md애니메이션 vs 정적 표시, 분해, 페이싱, 나레이션 동기화
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, 시간 기반 업데이터, 패턴
references/paper-explainer.md연구 논문을 애니메이션으로 변환 — 워크플로우, 템플릿, 도메인 패턴
references/decorations.mdSurroundingRectangle, Brace, 화살표, DashedLine, Angle, 주석 수명 주기
references/production-quality.md코딩 전, 렌더링 전, 렌더링 후 체크리스트, 공간 레이아웃, 색상, 템포

창의적 발산 (사용자가 실험적/창의적/독특한 출력을 요청할 때만 사용)

사용자가 창의적이거나, 실험적이거나, 기존과 다른 설명 방식을 요청하면, 애니메이션을 디자인하기 전에 전략을 선택하고 그 이유를 생각해 보세요.

  • SCAMPER — 사용자가 표준 설명에 새로운 시각을 원할 때
  • 가정 뒤집기 (Assumption Reversal) — 사용자가 무언가를 일반적으로 가르치는 방식에 도전하고자 할 때

SCAMPER 변환

표준 수학/기술 시각화를 가져와 변환하세요:

  • 대체 (Substitute): 표준 시각적 은유를 대체 (수직선 → 구불구불한 길, 행렬 → 도시 격자)
  • 결합 (Combine): 두 가지 설명 방식을 병합 (대수적 + 기하학적 동시에)
  • 역방향 (Reverse): 결과에서 시작하여 공리로 분해하는 역방향 유도
  • 변형 (Modify): 매개변수를 과장하여 그것이 왜 중요한지 보여줌 (학습률 10배, 표본 크기 1000배)
  • 제거 (Eliminate): 모든 기호 표기를 제거하고 오직 애니메이션과 공간적 관계로만 설명

가정 뒤집기 (Assumption Reversal)

  1. 이 주제가 일반적으로 어떻게 시각화되는지 '표준적인' 것들을 나열 (왼쪽에서 오른쪽, 2D, 이산적 단계, 형식적 표기)
  2. 가장 근본적인 가정 하나를 선택
  3. 그것을 뒤집음 (오른쪽에서 왼쪽으로 유도, 2D 개념을 3D로 임베딩, 단계 대신 연속적 모핑, 표기 제로)
  4. 뒤집힌 접근 방식이 표준 방식이 숨기는 것을 무엇을 드러내는지 탐구

관련 스킬