Communitygithub.com

remotion-software-explainer

시스템 설계, 분산 아키텍처, 디자인 패턴 등의 소프트웨어 엔지니어링 개념을 단일 화면 Log2Base2 형식의 몰입형 Remotion 동영상으로 생성합니다. 사용자가 /remotion과 함께 소프트웨어 엔지니어링을 설명해 달라고 요청할 때 사용하세요.

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

이 스킬은 사용자가 요청한 시스템 설계, 분산 시스템, 디자인 패턴 등의 소프트웨어 엔지니어링 주제를 하나의 통합된 시각적 무대(SinglePaneStage)에서 1920×1080 30fps MP4 Remotion 동영상으로 제작합니다. 화면을 분할하거나 텍스트 카드를 쌓는 대신, 상단에는 주제와 진행 상황을 표시하는 미니멀한 바, 중앙에는 전체 너비의 SVG 캔버스(1600×680)가 배치되어 서비스 노드와 애니메이션 파이프라인, 이동하는 요청 패킷, 실시간 게이지 등을 보여줍니다. 하단에는 워드바운더리 기반의 자막 바가 동기화되어 제공됩니다. 이 스킬은 Remotion, uv, edge-tts 등의 도구에 의존하며, CLI 명령어를 통해 스캐폴딩, 음성 합성, 최종 MP4 렌더링을 순차적으로 수행합니다. 사용자는 복잡한 아키텍처를 시각적으로 설명해야 할 때 이 스킬을 활용하여 효과적인 프레젠테이션 동영상을 빠르게 제작할 수 있습니다.

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

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

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

문서

Remotion 소프트웨어 엔지니어링 설명 동영상 (remotion-software-explainer)

개요

시스템 설계, 분산 아키텍처, 디자인 패턴, 데이터베이스 내부 구조, DevOps 워크플로 등 모든 주제를 프레임 동기화된 1920×1080 30fps MP4 Remotion 설명 동영상으로 변환합니다. 단일 화면 Log2Base2 스튜디오 형식을 사용합니다.

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

  1. 미니멀 상단 바 (SinglePaneStage 내장 44px):
    • 왼쪽에 주제 제목 + 활성 섹션 필, 오른쪽에 미묘한 단계 카운터 + 얇은 진행 막대.
  2. 하나의 통합된 Log2Base2 무대 (SinglePaneStage — 100% 너비):
    • 집중된 한 줄 스포트라이트 헤더: 활성화된 음성 요소(replicas: 3, ConsistentHash, WAL, CircuitBreaker)를 활성 사양/계약 줄에서 borderBottom: "2px solid #FACC15"로 강조 표시하고(절대로 가로 패딩을 추가하지 마세요) triggerFrame에 하나의 간결한 활성 콜아웃 필(term → architectural role)을 추가합니다.
    • 전체 너비 몰입형 SVG 캔버스 (viewBox="0 0 1600 680"): 음성에 따라 점진적으로 나타나는 서비스 노드(Client, API Gateway, Load Balancer, Microservices, Message Queue, Cache, DB Shards, K8s Pods), 애니메이션 대시 파이프라인으로 연결된 이동하는 요청 패킷, 실시간 캐시 적중/처리량 게이지, 동일한 열린 캔버스 위를 직접 흐르는 요청 추적 범위.
  3. 미니멀 하단 자막 바 (VoiceoverCaptionBar — 68px):
    • 정확한 TTS WordBoundary 타임스탬프에 의해 구동되는 깔끔한 중앙 정렬 단어별 강조 자막.

의존성

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md)
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md)

빠른 시작

# 1. 스캐폴딩
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/path/to/project" \
  --output "/path/to/project/scaffold-status.json"

# 2. 음성 합성
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-software-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 MP4 렌더링
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/path/to/project" \
  --composition-id "SoftwareExplainer" \
  --out-name "SoftwareExplainer.mp4" \
  --concurrency 8 \
  --output "/path/to/project/render-report.json"

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

  1. snippet을 집중적으로 유지하세요(2–4줄). <SinglePaneStage>가 하나의 활성 계약 줄을 스포트라이트하고 아키텍처 노드를 점진적으로 표시할 수 있도록 하며, 절대 처음부터 15개의 상자를 덤프하지 마세요.
  2. 이동하는 요청 패킷, 장애 조치(failover) 계단식 전파, 또는 오토스케일링 애니메이션이 있는 비트에는 "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-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.

관련 스킬