Communitygithub.com

remotion-software-explainer

ソフトウェア工学(システム設計、分散システム、マイクロサービス、Kubernetes/Docker、デザインパターン、データベース内部、CI/CD、ネットワーキング)を対象とした、没入型でフレーム同期されたシングルペインのRemotion解説動画を生成します。「/remotion」コマンドで簡単に利用できます。

remotion-software-explainer とは?

このスキルは、複雑なソフトウェアエンジニアリングの概念を、高品質なアニメーション動画として視覚化・説明するための強力なツールです。ユーザーがシステム設計やアーキテクチャの説明を求める際に、「/remotion」という指示に応じて動作します。Log2Base2スタジオ形式の単一ペインステージ上で、アーキテクチャ図のアニメーション、リクエストパケットの移動、ライブトレースタイムラインなどを1つのキャンバスに統合し、視聴者の理解を深めます。特徴として、トップバーにトピックと進行状況、メインステージにスポットライトで強調された構成要素とアニメーション、下部にワードバイワードのカラオケ字幕を備え、最終的に1080p 30fpsのMP4ファイルをレンダリングします。プロセスは、CLIツールを用いたプロジェクトのスキャフォールディング、音声合成、MP4レンダリングの3ステップで構成され、Remotionの強力なアニメーション機能を活用して、まるでプロフェッショナルな解説動画のようなアウトプットを生成します。

対応✓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解説動画に変換します。画面を分割して競合するペインやテキストカードを並べることはありません。すべての動画は 1つの統合ビジュアルステージ (<SinglePaneStage>) を使用します:

  1. 最小限のトップバー (44px、SinglePaneStage に内蔵) :
    • 左側にトピックタイトル + アクティブセクションピル;右側に控えめなステップカウンター + 細いプログレスバー。
  2. 1つの統合 Log2Base2 ステージ (SinglePaneStage — 100% 幅) :
    • 焦点を絞った1行のスポットライトヘッダー: アクティブなスペック/契約行 (replicas: 3、ConsistentHash、WAL、CircuitBreaker) 内の、読み上げ中の要素を borderBottom: "2px solid #FACC15" (水平方向のパディングは絶対に追加しない) で強調表示します。さらに triggerFrame において、1つの コンパクトなアクティブコールアウトピル (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> が 1つの アクティブな契約行をスポットライトで照らし、アーキテクチャノードを段階的に表示できるようにします。フレーム0に15個のボックスを一度に配置しないでください。
  2. 移動するリクエストパケット、フェイルオーバーカスケード、オートスケーリングアニメーションがあるビートには "motionStepFrames": 2 を設定します。
  3. 示す、語るな: リクエストパケットがノード間を移動する様子を、レイテンシー/キュー/トレースバーのライブデータと共に、同じ 全面 1600×680 SVG キャンバス内 (必要に応じて <clipPath> を使用) でアニメーション化します。分割画面のボックスで個別に表現しないでください。
  4. 必ず npm run lint を実行し、代表的な静止フレーム (npx remotion still) を read_file で確認し、最終的な .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.

関連スキル