Communitygithub.com

動画生成ツール

スクリプトから音声付きの高品質動画を無料で生成します。アニメーションモード(Reels/TikTok/Shorts向け1080×1920、キャラクター、単語単位の字幕、常に動くカメラ、BGM・エフェクト、サムネイル、品質管理機能付き)とチュートリアルモード(実際のWebページを撮影、カーソル・ズーム・ハイライト付き、2560×1440)をサポートします。動画の作成・録画・編集・調整・レビューや、スクリプトから動画への変換を依頼された場合に使用します。

動画生成ツール とは?

このスキルは、スクリプト(台本)を基に、ナレーション付きのプロフェッショナルな動画を自動生成するためのものです。主に2つのモードがあります。アニメーションモードは、キャラクター、単語単位のハイライト字幕、常に動くカメラワーク、BGM、エフェクトを含む、Reels/TikTok/Shorts向けの縦型動画(1080×1920)を生成します。一方、チュートリアルモードは、実際のWebページを録画し、カーソルの動き、ズーム、ハイライトを加えた横型動画(2560×1440)を生成します。このスキルは、品質管理のための自動チェック(解像度、FPS、静止画、音量など)、サムネイル生成、テキストの確認といった一連のツールを提供し、高品質な出力を保証します。内部のモーターはフレームごとに画像をレンダリングするため、ブラウザのスクリーンキャストのようなぼやけが生じません。また、外部音声合成サービス(Edge TTSやElevenLabs)を利用するため、機密情報をテキストに含めないよう注意が必要です。主にClaude Codeや類似のAIエージェント上で動作することを想定していますが、原理的には任意の開発環境で使用できます。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/gerador-de-video

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

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

ドキュメント

動画生成ツール は何をしますか?

ポルトガル語で回答してください。画面テキストとナレーションは専門用語を避けてください。新しい動画を作成する前に、docs/04_VIDEO_ANIMADO.md(アニメーション)またはdocs/01とdocs/02(チュートリアル)、およびdocs/03_QUALIDADE_E_CHECKLIST.mdを読んでください。

アニメーション動画のフロー(最も頻繁に依頼されます)

  1. スクリプト承認済み。 スクリプトがない場合は、roteiristaスキルを使用して、録画前にスクリプトとストーリーボードをユーザーに提示してください。
  2. テンプレートをコピー: videos/exemplo-bolinha-vermelha → videos/<動画の短い名前>(新しいフォルダを作成し、サンプルは絶対に変更しないでください)。
  3. roteiro.py: FALAS(1つのセリフ = 1つのシーン、cena="名前")、MARCA(チャンネル名、アバター)、および必要に応じてPERSONAGEM(ポーズのPNGが入ったフォルダ)を置き換えます。saida と saida_so_voz を調整します。
  4. pagina.html: 各シーンに対して、MONTA に登録された関数 cNome(r, c) を作成します。テンプレートのパーツを再利用します: quando(cena, "palavra")(音声がその単語を発する瞬間)、entra()(同期された入場)、sai()、anim()、personagem()(特定の単語でのポーズ変更、手に持つオブジェクトは.extraで指定)、bola()/bolaDiv()、jardim()、cachorro()、som()、エンドカード(montarFim)およびサムネイル(montarCapa、render(t < 0) で描画)。色は --fundo、--tinta、--destaque で指定。
  5. 全量録画前に確認: py motor/animar.py videos/<フォルダ> --fotos 0,3,8,15(実際の解像度のPNGがsaida/fotosに出力されます)を実行し、シーンごとに確認するためのシートを作成します。音声付きでテストする場合: --ate 12。
  6. 録画: py motor/animar.py videos/<フォルダ> を実行します。BGM付きMP4、「音声のみ」バージョン、および saida/controle_de_qualidade.json(自動QA:解像度、FPS、1秒以上の静止画、繰り返しフレーム、黒画面、音量-14 LUFS、ピーク)が出力されます。
  7. サムネイル: py ferramentas/capa.py videos/<フォルダ> → saida/Capa.png。
  8. テキスト確認: py ferramentas/verificar_textos.py videos/<フォルダ>(テキストの途切れ、はみ出し、Instagramのボタンの下への被りをチェック)。
  9. ファイルパスを提示し、ユーザーが聴いて確認すべき点を伝えてください(あなたは音声を聞けません)。絶対に公開しないでください。
  10. 公開前(オプション、QA承認後): 次元による編集QA(py creative-intelligence/ci.py avaliacao modelo ...)、バージョン間のフック比較(ci comparar)、および予測評価(Higgsfield)は、コスト承認と素材所有者の許可がある場合のみ実行します(ci prever ... --modelo-autorizacao)。engenharia-reversaスキルのセクション5を参照してください。録画やチュートリアルには必須ではありません。モーターはこれらに依存しません。

コマシート(2秒ごと): ffmpeg -i saida/<動画>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png。

チュートリアルモード(実際のWebページ)

modelos/roteiro_modelo.py を videos/<フォルダ>/roteiro.py にコピーします。アクションは docs/02_ACOES_DO_ROTEIRO.md に記載されています。 テスト: py motor/gravar.py videos/<フォルダ> --so 02-04、その後動画全体を録画。

過去に高くついたルール(繰り返さないこと)

  • render(t) は t のみ に依存します(前のフレームからのデータを保持しない)。グラデーションのストップは常に順序通りに。
  • 決して止めない: カメラは常に動き続けます(ゆっくりとした接近 + 微動)。クリップが終わると後ろから前に戻る。エンドカードも動く。
  • 最初のフレームでアクション: 最初の1秒で既に謎を表示します(空のシーンで待たせない)。
  • Reels(1080 × 1920): タイトルは150〜440 pxの間に。字幕は約1330 px、1ブロック最大約16文字(860 pxの制限)。1100〜1750 pxの範囲では、1600 pxより下、または右側(x > 960)に重要なものを配置しないでください — Instagramのボタンと説明文のエリアです。
  • デモのオブジェクトは大きく表示します。カメラを近づけてください。オブジェクトの手前の芝生/要素はオブジェクトの基部にのみ配置します。
  • 「Before/After」比較は両方のフレームで同じフレーミングにし、両者の間に明確なトランジション(例:ワイプ)を入れます。
  • 縦型動画の場合、中央に水平の帯を入れないでください。水平クリップは縦型にトリミングして入れます(最大拡大率約1.2倍)。
  • キャラクターのPNG: 背景が本当に透明であることを確認してください(5%の色が動画内で四角形になります)。
  • 意図的なズームは、0.5秒未満の間、テキストを画面外に出すことがあります。それ以外は、テキストチェッカーがクリアになっている必要があります。
  • ブラウザのスクリーンキャストやPlaywrightの動画は使用しないでください(ぼやけて出力されます)。モーターはフレームごとに写真を撮影します。
  • roteiro.py 内のWindowsのパスは常に r"..." としてください。
  • 音声: 短いフレーズ。vozes.py はフレーズごとに生成し、間に呼吸を入れます(voz["respiro"])。自然なリズムは毎秒2.4〜3.2語(モーターが再生時間を表示します。語数 ÷ 秒数)。
  • ストック映像クリップ: 使用を許可するライセンスのもののみ(Mixkitの「Free」。 「Restricted」は広告を禁止)。midia/CREDITOS.md に記録します。

セキュリティ

  • 音声は外部サービス(Edge TTS または ElevenLabs)に送信されます。発話テキストに氏名、CPF、顧客データを決して入れないでください。
  • キーは ~/.secrets/ にのみ配置します(ElevenLabs: ~/.secrets/elevenlabs/.env)。決して表示したり、リポジトリにコピーしたりしないでください。
  • シミュレーションや架空のキャラクターの場合: 画面上にラベルを表示します(「近似シミュレーション」、「架空のキャラクター」)。
  • ユーザーの承認なしに有料APIクレジットを使用しないでください。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル