Communitygithub.com

리모션 수학 설명기

수학(미적분학, 선형대수학, 미분방정식, 확률론, 증명)을 위한 동기화된 몰입형 단일 패널 리모션 시각 설명 영상을 제작합니다. 순수 Log2Base2 단일 스테이지 형식을 사용하며, 집중된 단일 방정식 스포트라이트, 전체 화면 3Blue1Brown x Log2Base2 스타일의 애니메이션 기하/데이터 모션 그래픽, 워드바운더리 가사 자막, 빠른 1080p MP4 렌더링을 제공합니다. 사용자가 /remotion으로 수학을 설명해 달라고 하거나, 유도 과정이나 정리를 애니메이션으로 만들거나, 수학 스크립트를 MP4 설명 영상으로 변환해 달라고 요청할 때 사용하세요.

리모션 수학 설명기란 무엇인가요?

이 스킬은 수학적 유도, 정리, 증명 또는 슬라이드 덱을 완전히 동기화된 1920×1080 30fps MP4 Remotion 설명 영상으로 변환합니다. 단일 통합 시각 스테이지(SinglePaneStage)를 사용하여 시청자의 주의를 분산시키지 않고 하나의 이야기에 집중하도록 합니다. 주요 기능으로는 현재 단계 제목과 강조 표시된 활성 방정식 한 줄만 보여주는 집중된 단일 라인 스포트라이트 헤더, 1600x680 viewBox의 전체 너비 몰입형 SVG 캔버스(라이브 좌표 격자, 데이터 포인트, 넘버 플라잉, 레이저 크로스아웃 등), 그리고 정확한 TTS 워드바운더리 타임스탬프를 기반으로 한 워드바이워드 가사 자막이 포함됩니다. 이 스킬은 Claude Code 및 유사한 AI 에이전트 환경에서 작동하며, 'uv' 및 'remotion-best-practices' 스킬에 의존합니다. CLI 명령어를 통해 프로젝트 스캐폴딩, 신경망 음성 해설 합성, 빠른 8-워커 키프레임 중복 제거 렌더러를 사용한 최종 MP4 렌더링을 지원합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/uzowurumauritius-rgb/remotion-stage/tree/main/skills/remotion-math-explainer

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

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

문서

리모션 수학 설명기 (remotion-math-explainer)

개요

모든 수학적 유도, 정리, 증명 또는 슬라이드 덱을 프레임 동기화된 1920×1080 30fps MP4 리모션 설명 영상으로 단일 패널 Log2Base2 스튜디오 형식으로 변환합니다.

화면을 경쟁하는 나란히 있는 패널이나 쌓인 텍스트 카드 벽으로 분할하지 마십시오. 모든 비디오는 하나의 통합된 시각적 스테이지 (<SinglePaneStage>)를 사용하여 시청자의 전체 주의가 시각적 이야기에 고정되도록 합니다:

  1. 최소 상단 바 (44px, SinglePaneStage에 내장) :
    • 왼쪽에는 주제 제목 + 현재 활성 섹션 필; 오른쪽에는 미묘한 단계 카운터 + 얇은 진행률 표시줄.
  2. 하나의 통합된 Log2Base2 스테이지 (SinglePaneStage — 100% 너비) :
    • 집중된 단일 라인 스포트라이트 헤더: 오직 현재 단계 제목과 단일 활성 방정식 라인만 표시합니다 (활성 음성 단어를 제자리에서 borderBottom: "2px solid #FACC15"로 강조 표시하며, 절대 수평 패딩을 추가하지 않음) 그리고 triggerFrame에서 스프링 인되는 하나의 컴팩트한 활성 토큰 콜아웃 필 (symbol → 평범한 영어 의미)이 포함됩니다.
    • 전체 너비 몰입형 SVG 캔버스 (viewBox="0 0 1600 680") : 넉넉하고 연속적인 모션 그래픽 — 라이브 좌표 격자와 늘어나고 접히는 색상 데이터 포인트, 행렬에서 작은 블록으로 물리적으로 미끄러지는 숫자, 휩쓰는 레이저 크로스아웃, 부호 있는 크기 막대, 항등 행렬로 되돌아가는 3D 단위 큐브 — 동일한 열린 캔버스에 직접 통합됩니다.
  3. 최소 하단 자막 바 (VoiceoverCaptionBar — 68px) :
    • 정확한 TTS WordBoundary 밀리초 타임스탬프에 의해 구동되는 깔끔한 중앙 정렬 워드바이워드 강조 자막.

종속성

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md): 모든 Remotion 애니메이션 규칙 (useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts, 제로 CSS 트랜지션)에 대해 따라야 합니다.
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md): 신경망 음성 해설 합성을 위해 uv run --with edge-tts를 실행하는 데 필요합니다.

빠른 시작

# 1. 리모션 수학 설명기 프로젝트 스캐폴드
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/path/to/project" \
  --output "/path/to/project/scaffold-status.json"

# 2. 자연스러운 신경망 음성 해설 + 정확한 WordBoundary 및 용어 타임스탬프 합성
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/path/to/project" \
  --beats-json "/path/to/project/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/path/to/project/public/voiceover/manifest.json"

# 3. 빠른 8-워커 키프레임 중복 제거 렌더러를 통해 최종 1080p 30fps MP4 렌더링
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/path/to/project" \
  --composition-id "MathExplainer" \
  --out-name "MathExplainer.mp4" \
  --concurrency 8 \
  --output "/path/to/project/render-report.json"

몰입형 스토리텔링 및 워크플로우

  1. 에너제틱 비트 설계 (beats.json) :
    • 대화형, 훅 우선 내레이션 작성 (건조한 교과서 문체 피하기)하여 동기 부여가 부족한 학생도 참여를 유지합니다.
    • snippet을 2–4개의 선명한 라인으로 유지하고 각 token이 한 줄에 그대로 나타나며 text의 깔끔한 단일 소문자 triggerWord와 일치하도록 합니다.
    • 연속적인 곡선, 벡터, 격자 또는 비행 요소 애니메이션이 있는 비트에 대해 "motionStepFrames": 2로 설정합니다.
  2. 음성 해설 스캐폴드 및 합성:
    • scripts/explainer_cli.py를 통해 scaffold (SinglePaneStage.tsx, VoiceoverCaptionBar.tsx, render_full_mp4.mjs 복사) 및 synthesize-voiceover를 실행합니다.
  3. 전체 캔버스 모션 그래픽 작성 (viewBox="0 0 1600 680") :
    • 몰입형 SVG 스테이지를 children으로 <SinglePaneStage>에 전달합니다.
    • 보여주세요, 말하지 마세요: 정적 글머리 기호/텍스트 카드를 물리적 모션으로 대체 — 좌표 왜곡을 타는 입자/포인트, 위치 사이를 비행하는 요소, 휩쓰는 레이저 라인, 라이브 게이지, 동일한 열린 캔버스 안에 나란히 있는 라이브 플롯.
    • 왜곡/확장 그리드라인은 항상 <clipPath> 안에 감싸서 모션이 레이블이나 필을 넘어 흐르지 않도록 합니다.
  4. 스틸 확인 및 최종 MP4 렌더링:
    • render-mp4를 실행하기 전에 npm run lint를 실행하고 read_file로 대표 스틸 프레임 (npx remotion still)을 검사합니다.
    • 최종 .mp4를 out/, 프로젝트 루트, 작업 공간 루트에 복사합니다.

속도 제한 및 일반적인 실수

  • scripts/explainer_cli.py는 /tmp/remotion_edge_tts.lock을 적용합니다 (0.35s 간격, 1s/2s/4s 백오프로 3회 재시도).
  • 절대 다중 패널 분할 화면 레이아웃을 사용하거나 테두리가 있는 하위 카드를 쌓지 마십시오 — <SinglePaneStage>를 사용하여 엄격하게 하나의 기본 창만 화면에 표시되도록 합니다.
  • 절대 한 번에 전체 다단계 증명을 화면에 덤프하지 마십시오; 한 번에 하나의 활성 방정식 라인과 하나의 활성 콜아웃 필을 스포트라이트합니다.
  • 절대 강조 표시된 인라인 토큰에 수평 padding을 추가하지 마십시오 (borderBottom: "2px solid #FACC15" 및 backgroundColor만 사용).

Individual skills in this repo

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

remotion-code-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for source code (Mobile/Web UI, Backend, AI/ML, Algorithms) in a pure Log2Base2 single-stage format—with a focused single-line code spotlight, full-screen animated memory boxes, pointer arrows, data packets, and live execution state on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain code with /remotion, build a code walkthrough video, or turn a voiceover script into an MP4 explainer.

remotion-electronic-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Electronic Engineering (Semiconductors, PN Junctions, Diodes, BJTs, MOSFETs, CMOS Logic, Op-Amp IC Stages, ADC/DAC, PCB Signal Integrity) in a pure Log2Base2 single-stage format—with a focused single-line device equation spotlight, full-screen animated carrier/channel diagrams and live I-V curves on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain electronic engineering, semiconductors, transistors, or analog/digital ICs with /remotion.

remotion-physics-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Physics (Mechanics, Electromagnetism, Thermodynamics, Optics/Waves, Quantum Mechanics, Relativity) in a pure Log2Base2 single-stage format—with a focused single-line governing law spotlight, full-screen animated free-body/field/wave simulations and live telemetry on one canvas, millisecond-accurate WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain physics with /remotion or animate a physical law/system.

remotion-software-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Software Engineering (System Design, Distributed Systems, Microservices, Kubernetes/Docker, Design Patterns, Database Internals, CI/CD, Networking) in a pure Log2Base2 single-stage format—with a focused single-line contract/YAML spotlight, full-screen animated architecture flows with traveling request packets and live trace timelines on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain software engineering, system design, or architecture with /remotion.

관련 스킬