Communitygithub.com

remotion-physics-explainer

물리학 개념, 법칙 또는 문제를 동기화된 단일 화면 Remotion 설명 동영상(1920×1080 30fps MP4)으로 변환합니다. 역학, 전자기학, 열역학, 광학/파동, 양자 역학, 상대성 이론 등 물리학 전 분야를 지원합니다.

remotion-physics-explainer란 무엇인가요?

`remotion-physics-explainer`는 물리학 주제를 Log2Base2 단일 스테이지 형식의 몰입형 Remotion 설명 동영상으로 제작하는 강력한 기술 스킬입니다. 이 스킬은 단일 통합 캔버스(`SinglePaneStage`)에서 하나의 지배 방정식 스포트라이트, 전체 화면 SVG 애니메이션(진자, 궤적, 장, 파동 등), 실시간 텔레메트리, 밀리초 정확도의 워드바운더리 가라오케 자막을 결합합니다. 주요 사용 사례는 사용자가 `/remotion`을 이용해 물리학 개념을 설명하거나 특정 물리 법칙/시스템을 애니메이션으로 시각화해 달라고 요청할 때입니다. 이 스킬은 `remotion-best-practices`와 `uv`에 의존하며, `explainer_cli.py`를 통해 스캐폴딩, 음성 합성(edge-tts 사용), 최종 1080p MP4 렌더링을 자동화하는 세 단계 워크플로를 제공합니다. 핵심 철학은 '보여주고 말하지 않는 것(Show, don't tell)'으로, 모든 물리적 시뮬레이션과 설명을 분할 화면 없이 하나의 넓은 SVG 캔버스에서 펼쳐 매우 몰입감 있는 학습 경험을 제공합니다.

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

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

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

문서

Remotion Physics Explainer (remotion-physics-explainer)

개요

어떤 물리학 개념, 법칙 또는 문제를 단일 패널 Log2Base2 스튜디오 형식의 프레임 동기화된 1920×1080 30fps MP4 Remotion 설명 동영상으로 변환합니다.

화면을 경쟁하는 나란히 있는 창이나 쌓인 텍스트 카드 벽으로 분할하지 않습니다. 모든 동영상은 하나의 통합된 시각적 스테이지(<SinglePaneStage>)를 사용합니다:

  1. 최소 상단 바 (SinglePaneStage에 내장된 44px):
    • 왼쪽: 주제 제목 + 활성 섹션 파일; 오른쪽: 미묘한 단계 카운터 + 얇은 진행률 표시줄.
  2. 하나의 통합된 Log2Base2 스테이지 (SinglePaneStage — 100% 너비):
    • 집중된 한 줄 스포트라이트 헤더: 활성 구절 물리 기호(F, m, a, E, B, λ, Ψ, ΔS)를 활성 방정식 줄에 borderBottom: "2px solid #FACC15"로 강조 표시합니다(가로 패딩 절대 추가 금지). 또한 triggerFrame에 하나의 간결한 활성 설명 파일(기호 → 물리적 의미 + SI 단위)을 추가합니다.
    • 전체 너비 몰입형 SVG 캔버스 (viewBox="0 0 1600 680"): 넓은 실시간 물리 시뮬레이션 — 진자, 발사체 궤적, $\vec{B}$-장에서 휘는 대전 입자, 간섭하는 파면, 에너지 막대 전달, 실시간 벡터 오버레이 — 동일한 열린 캔버스에서 직접 애니메이션됩니다.
  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. Remotion 물리 설명 프로젝트 스캐폴딩
uv run python3 \
  ~/.gemini/config/skills/remotion-physics-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-physics-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. 최종 1080p 30fps MP4 렌더링
uv run python3 \
  ~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/path/to/project" \
  --composition-id "PhysicsExplainer" \
  --out-name "PhysicsExplainer.mp4" \
  --concurrency 8 \
  --output "/path/to/project/render-report.json"

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

  1. snippet을 집중적으로 유지하세요 (2–4줄). 이렇게 하면 <SinglePaneStage>가 한 번에 하나의 활성 방정식과 하나의 활성 기호 설명 파일을 스포트라이트할 수 있습니다.
  2. 연속적인 물리적 움직임(진자, 파동, 장, 입자)이 있는 비트에는 "motionStepFrames": 2를 설정하세요.
  3. 보여주고 말하지 마세요: 힘, 장, 에너지 교환, 실시간 움직임 그래프를 동일한 전체 너비 1600×680 SVG 캔버스 내에서 (clipPath를 사용하여 움직이는 플롯/파동 처리) 함께 애니메이션하세요. 별도의 분할 화면 상자를 절대 사용하지 마세요.
  4. 항상 npm run lint를 실행하고, read_file과 함께 대표적인 정지 프레임(npx remotion still)을 검사하고, 최종 .mp4를 out/, 프로젝트 루트, 작업 공간 루트에 저장하세요.

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-math-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Mathematics (Calculus, Linear Algebra, Differential Equations, Probability, Proofs) in a pure Log2Base2 single-stage format—with a focused single-line equation spotlight, full-screen 3Blue1Brown x Log2Base2 animated geometric/data motion graphics, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain math with /remotion, animate a derivation or theorem, or turn a math script into an MP4 explainer.

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.

관련 스킬