Communitygithub.com

govindgoel2001/video-editing-toolkit

Manim Community Edition を用いた数理・技術アニメーションの制作パイプライン。3Blue1Brown スタイルの解説動画、アルゴリズム可視化、数式導出、アーキテクチャ図、データストーリーを作成します。

video-editing-toolkit とは?

このスキルは、Manim Community Edition をベースにした動画制作パイプラインであり、数理・技術系アニメーション解説動画を効率的に作成するためのものです。ユーザーが「アニメーション解説」「数学アニメーション」「アルゴリズム可視化」「3Blue1Brown スタイルの動画」などをリクエストした際に活用します。単なる動画作成ツールではなく、教育的な映像制作のための創造的原則(クリエイティブ・スタンダード)が定義されており、幾何学的直観を優先し、視覚的にまとまりのある作品を第一回目のレンダリングで仕上げることを求めます。パイプラインは PLAN → CODE → RENDER → STITCH → AUDIO(任意)→ REVIEW の6ステップで構成され、各プロジェクトは単一の Python スクリプトで管理されます。カラーパレット、アニメーション速度、タイポグラフィスケールなどの統一的なガイドラインが用意されており、異なるシーン間でも一貫した視覚言語を保つことができます。また、必要に応じて SCAMPER や前提反転などの創造的発想法を用いた、実験的・独創的な解説アプローチにも対応しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/video-use/skills/manim-video

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Manim 動画制作パイプライン

クリエイティブ・スタンダード

これは教育映画です。すべてのフレームが教え、すべてのアニメーションが構造を明らかにします。

コードを1行書く前に、ナラティブアークを明確にしてください。このアニメーションはどのような誤解を正すのか?「aha モーメント」はどこか?視聴者を混乱から理解へと導く視覚的なストーリーは何か?ユーザーのプロンプトは出発点です — 教育的な野心を持って解釈してください。

幾何学を代数より先に。 形を先に見せ、方程式は後から。視覚記憶は記号記憶より速くエンコードされます。視聴者が数式の前に幾何学的パターンを見るとき、方程式は「獲得された」ものとして感じられます。

初回レンダリングでの完成度は譲れません。 出力は、修正ラウンドなしで視覚的に明確で審美的にまとまっている必要があります。何かが散らかっていたり、タイミングが悪かったり、「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 (オプション)ナレーションボイスオーバー

パイプライン

PLAN --> CODE --> RENDER --> STITCH --> AUDIO (オプション) --> REVIEW
  1. PLAN — ナラティブアーク、シーンリスト、視覚要素、カラーパレット、ボイスオーバースクリプトを記載した plan.md を作成
  2. CODE — 各シーンに1クラス、それぞれ独立してレンダリング可能な script.py を作成
  3. RENDER — ドラフトは manim -ql script.py Scene1 Scene2 ...、本番は -qh
  4. STITCH — ffmpeg でシーンクリップを結合し final.mp4 を作成
  5. AUDIO (オプション) — ffmpeg でボイスオーバーやBGMを追加。references/rendering.md を参照
  6. REVIEW — レンダリングプレビュースチルを生成し、計画と照らし合わせて確認・調整

プロジェクト構造

project-name/
  plan.md                # ナラティブアーク、シーン分割
  script.py              # すべてのシーンを1ファイルに
  concat.txt             # ffmpeg シーンリスト
  final.mp4              # 結合された出力
  media/                 # Manim が自動生成
    videos/script/480p15/

クリエイティブ・ディレクション

カラーパレット

パレット背景プライマリセカンダリアクセント使用例
クラシック 3B1B#1C1C1C#58C4DD (BLUE)#83C167 (GREEN)#FFFF00 (YELLOW)一般的な数学/CS
ウォームアカデミック#2D2B55#FF6B6B#FFD93D#6BCB77親しみやすい
ネオンテック#0A0A0A#00F5FF#FF00FF#39FF14システム、アーキテクチャ
モノクローム#1A1A2E#EAEAEA#888888#FFFFFFミニマリスト

アニメーション速度

コンテキストrun_time後の self.wait()
タイトル/イントロ出現1.5s1.0s
重要な数式リビール2.0s2.0s
変換/モーフィング1.5s1.5s
補助ラベル0.8s0.5s
FadeOut クリーンアップ0.5s0.3s
「Aha モーメント」リビール2.5s3.0s

タイポグラフィスケール

役割フォントサイズ使用法
タイトル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)

シーンごとに1クラス。すべてのシーンは独立してレンダリング可能です。

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("Why Does This Work?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Why does this work?", 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("text", duration=N) または self.play() の subcaption="text"
  • シーン間の一貫性のために、ファイル上部に共有色定数を定義
  • 全シーンで **self.camera.background_color** を設定
  • クリーンな終了 — シーン終了時にすべてのモブジェクトを 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) しない

未追加のモブジェクトをアニメーションしない

self.play(Create(circle))  # 最初に追加する必要がある
self.play(circle.animate.set_color(RED))  # その後アニメーション

パフォーマンス目標

品質解像度FPS速度
-ql (ドラフト)854x480155-15秒/シーン
-qm (中品質)1280x7203015-60秒/シーン
-qh (本番)1920x10806030-120秒/シーン

常に -ql で反復します。最終出力のみ -qh でレンダリングします。

リファレンス

ファイル内容
references/animations.mdコアアニメーション、レート関数、合成、.animate 構文、タイミングパターン
references/mobjects.mdテキスト、図形、VGroup/Group、配置、スタイリング、カスタムモブジェクト
references/visual-design.md12のデザイン原則、不透明度レイヤリング、レイアウトテンプレート、カラーパレット
references/equations.mdManim での LaTeX、TransformMatchingTex、導出パターン
references/graphs-and-data.mdAxes、プロット、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): 2つの説明アプローチを統合する(代数的+幾何学的を同時に)
  • 反転 (Reverse): 結果から逆に導出する — 結論から始めて公理に分解する
  • 修正 (Modify): パラメータを誇張してその重要性を示す(学習率を10倍、サンプルサイズを1000倍)
  • 排除 (Eliminate): すべての表記を削除 — アニメーションと空間関係だけで純粋に説明する

前提反転

  1. このトピックがどのように可視化されるか「標準的」なことをリストアップする(左から右、2D、離散ステップ、形式的表記)
  2. 最も基本的な前提を選ぶ
  3. それを反転する(右から左への導出、2D 概念の 3D 埋め込み、ステップの代わりに連続モーフィング、表記ゼロ)
  4. 反転が、標準的なアプローチが隠している何を明らかにするかを探求する

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

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 CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

関連スキル