Communitygithub.com

delorenj/skills

Manim CE 애니메이션: 3Blue1Brown 스타일의 수학/알고리즘 영상 제작 파이프라인

skills란 무엇인가요?

이 스킬은 개발자나 교육 콘텐츠 제작자가 Manim Community Edition을 사용하여 3Blue1Brown 스타일의 고품질 애니메이션 설명 영상을 제작할 수 있도록 지원하는 전문 도구입니다. 개념 설명, 방정식 유도, 알고리즘 시각화, 데이터 스토리, 아키텍처 다이어그램, 논문 설명, 3D 시각화 등 다양한 모드를 제공하며, 각 모드에 맞는 참조 문서를 제공합니다. 이 스킬은 Python 3.10+, Manim CE v0.20+, LaTeX, ffmpeg 환경에서 실행되며, 단일 Python 스크립트 기반의 간단한 워크플로우(계획 → 코딩 → 렌더링 → 이어붙이기 → 오디오 → 검토)를 따릅니다. 특히 교육적 내러티브 설계, 시각적 일관성(색상 팔레트, 타이포그래피, 애니메이션 속도), 청중의 이해를 돕기 위한 'aha 순간' 연출 등 창의적이고 교육적인 영화 제작 원칙에 중점을 두고 있습니다.

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

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

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

문서

Manim 비디오 제작 파이프라인

사용 시점

사용자가 다음을 요청할 때 사용: 애니메이션 설명, 수학 애니메이션, 개념 시각화, 알고리즘 워크스루, 기술 설명, 3Blue1Brown 스타일 비디오, 또는 기하학적/수학적 콘텐츠가 포함된 프로그래매틱 애니메이션. Manim Community Edition을 사용하여 3Blue1Brown 스타일의 설명 비디오, 알고리즘 시각화, 방정식 유도, 아키텍처 다이어그램, 데이터 스토리를 제작합니다.

창작 기준

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

코드를 한 줄도 작성하기 전에, 내러티브 아크를 명확히 하세요. 이 영상이 교정하려는 오해는 무엇인가요? "아하 순간"은 무엇인가요? 시청자를 혼란에서 이해로 이끄는 시각적 스토리는 무엇인가요? 사용자의 프롬프트는 출발점일 뿐이며, 교육적 야망을 가지고 해석하세요.

대수보다 기하를 먼저. 방정식보다 먼저 형태를 보여주세요. 시각적 기억은 상징적 기억보다 빠르게 인코딩됩니다. 시청자가 공식 이전에 기하학적 패턴을 보면, 방정식이 자연스럽게 느껴집니다.

첫 렌더링의 완성도는 타협할 수 없습니다. 출력물은 수정 없이 시각적으로 명확하고 미학적으로 일관되어야 합니다. 어수선하거나 타이밍이 나쁘거나 "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 (Linux에서는 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 (파란색)#83C167 (초록색)#FFFF00 (노란색)일반 수학/CS
따뜻한 학술#2D2B55#FF6B6B#FFD93D#6BCB77친근한
네온 테크#0A0A0A#00F5FF#FF00FF#39FF14시스템, 아키텍처
단색#1A1A2E#EAEAEA#888888#FFFFFF미니멀리스트

애니메이션 속도

맥락run_timeself.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("왜 이것이 작동할까요?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("왜 이것이 작동할까요?", 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("텍스트", duration=N) 또는 self.play()에 subcaption="텍스트"
  • 파일 상단의 공유 색상 상수로 장면 간 일관성 유지
  • 모든 장면에서 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))  # 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 — 사용자가 표준 설명에 신선한 접근을 원할 때
  • 가정 뒤집기 — 사용자가 일반적인 교수 방식을 도전하고 싶을 때

SCAMPER 변환

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

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

가정 뒤집기

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

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

관련 스킬