Communitygithub.com

cordel

テーマに基づいて、決められた「コルデル」ビジュアルスタイルで短い解説動画(9:16、16:9、1:1)を生成します。

cordel とは?

このスキルは、ユーザーが指定したテーマから、常に一定のビジュアルスタイル(「コルデル」スタイル)で短い解説動画を自動生成するためのエージェントスキルです。対応プラットフォームは、CodexやClaude CodeなどのAIエージェント環境を想定しており、ローカル実行用のPythonスクリプト群(cenas.py、recortar.py、animar.py、narrar.py、montar.py、validar.pyなど)が提供されています。ワークフローは、テーマ・フォーマット・尺・解像度・エンジンの設定から始まり、シーン設計、ストーリーボードの生成(スタイル遵守の確認含む)、カット、アニメーション、ナレーション、BGM付きの最終動画出力、そして最終的なバリデーションまでを10ステップに分けて実行します。特徴的なのは、スタイルの「バイブル」とも言える`references/estilo.md`などの設定ファイルを参照し、すべての動画で一貫したルック&フィールを保証する点です。また、過去の失敗を`references/licoes.md`に記録し、スタイルやストーリーボードのルール自体を改善することで、スキル自体を継続的に進化させる設計になっています。ユーザーは「cordelスタイルで動画を作って」と依頼するだけで、一連の複雑な処理をエージェントが代行します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/inematds/estilo-em-skill/tree/HEAD/exemplos/cordel/skill

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

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

ドキュメント

スタイルスキル: cordel

このスキルは、常に同じスタイルで動画を作成します。スタイルは references/estilo.md(バイブル)に定義されています。 コンテンツはユーザーのリクエストに基づきます。スタイルのインスピレーション元となった動画のキャラクター、ロゴ、テキストをコピーしないでください。

SKILL_DIR = このファイルが置かれているフォルダ。スクリプトは SKILL_DIR/scripts/ にあり、python3 で実行します。 作業は動画プロジェクトフォルダ(デフォルトはカレントフォルダ)で行います。すべての出力は saida/ と final/ フォルダに配置されます。

事前準備

  1. references/estilo.md、references/regras-storyboard.md、references/regras-video.md を読み、さらに references/licoes.md(このスタイルで過去に発生した問題)があればそれも読んでください。
  2. ツールを確認します: ffmpeg -version、python3 -c "import PIL"。不足しているものがあれば、インストール方法を伝えて停止してください。

ステップ1 — 5つのデータ(不足があれば自由文で尋ね、デフォルト値を提示)

データオプションデフォルト
テーマフレーズ1つ—(必須)
フォーマット9:16 · 16:9 · 1:19:16
尺(秒)秒; 2.5の倍数になる15
解像度例: 1080x1920フォーマットに応じた値 (9:16 → 1080x1920, 16:9 → 1920x1080, 1:1 → 1080x1080)
エンジンlocal (無料、テスト済み) · kling · seedance (プロンプトのみ、未テスト)local

ステップ2 — シーン計画

python3 SKILL_DIR/scripts/cenas.py --tema "<テーマ>" --duracao <秒> --formato <f> --resolucao <WxH> --motor <m>

シーン数(各2.5秒)とストーリーボード数(最大6シーン/1ストーリーボード)が表示されます。尺が正規化された場合は、その旨をユーザーに伝えてください。

ステップ3 — 脚本(あなたが書く)

references/regras-video.md に従って roteiro.json を書いてください(各シーンの台詞は最大6単語、各シーンに1つの大きなキーワード、最初のシーンは視聴者の「痛点」または「欲望」から始まり、「あなた」宛ての呼びかけであること):

{"personagem": "複数シーンに登場するキャラクターを、常に同じ記述で(服装、色、アクセサリー)",
 "cenas": [{"texto_tela": "キーワード", "fala": "話す短いフレーズ", "acao": "見える動作", "camera": "zoom_in"}]}

personagem はすべてのストーリーボードリクエストに含められます(これがないと、ストーリーボードごとに別の人が生成されてしまいます)。その後:

python3 SKILL_DIR/scripts/cenas.py ... --roteiro roteiro.json     # 同じコマンド + 脚本ファイル

ステップ4 — スタイルに沿ったストーリーボード

テンプレート + バイブル + 計画 + キャラクターから、ストーリーボードごとのリクエストを作成します:

python3 SKILL_DIR/scripts/pedido_storyboard.py          # → saida/storyboards/pedido-storyboard-N.txt

各リクエストを書き換えずに、画像生成ツールに送信します(Codex: image_gen; Claude Code: 使用可能な画像ツール、またはユーザーに生成と保存を依頼)。saida/storyboards/storyboard-N.png に保存します。 リクエストを変更する場合は、生成されたテキストではなく、テンプレート(modelos/prompt-storyboard.md)またはバイブルを変更してください。

  • 1枚ずつ生成します。2枚目以降は、前のストーリーボードを参照画像として渡します(一貫性のため)。
  • 画像を開いて regras-storyboard.md のリストと照合してください(正しいグリッド、単語が一字一句合っているか、スタイル、一貫性)。単語を拡大して確認します。不適切な場合は、やり直し(最大2回)、references/licoes.md に記録してください。

ステップ5 — 切り抜き

python3 SKILL_DIR/scripts/recortar.py --plano saida/plano.json      # --respiro 0.08(デフォルト) ズームで単語を保護

ステップ6 — アニメーション

python3 SKILL_DIR/scripts/animar.py                      # ローカルエンジン: ゆっくりズーム/パン + ディゾルブ
python3 SKILL_DIR/scripts/animar.py --motor kling --so-prompts      # 未テスト: コマンドのみ出力
python3 SKILL_DIR/scripts/animar.py --motor seedance --so-prompts   # 未テスト: プロンプトのみ出力

kling/seedance を使用する場合、実行はユーザー自身のアカウントで行います。後でクリップは saida/clipes/ に戻されます。

ステップ7 — ナレーション(単一の声)

python3 SKILL_DIR/scripts/narrar.py --arquivo voz.wav            # ユーザーがすべて録音
python3 SKILL_DIR/scripts/narrar.py --falas-dir falas/           # ユーザーがシーンごとに1つの台詞を録音
python3 SKILL_DIR/scripts/narrar.py --comando '<tts> {texto} {saida}'   # 任意のローカルTTS
python3 SKILL_DIR/scripts/narrar.py --inemavox --inemavox-dir <フォルダ> --ref <voz.wav>
python3 SKILL_DIR/scripts/narrar.py --edge                       # 未テスト(オンラインサービス)

TTS 使用時、narrar.py は音声がフレーズの後に生成する「尻尾」をカットし、指定単語数に対して長すぎる台詞を再生成します(--tentativas 3)。台詞がシーンを超えた場合は、脚本の台詞を短くして再実行してください。可能であれば、ローカルの文字起こしでナレーションを確認してください(フレーズが脚本と一致しているか); 問題のある台詞 → narrar.py ... --refazer N でシーンNのみ再生成。

ステップ8 — 単一BGMで編集

python3 SKILL_DIR/scripts/montar.py [--trilha assets/trilha/x.mp3] [--volume 0.5]

assets/trilha/ にBGMがない場合は、ユーザーに使用する曲を尋ねてください(ユーザー所有またはライセンス済みのもの)。複数ある場合は選択を依頼してください。

ステップ9 — 確認(必須)

python3 SKILL_DIR/scripts/validar.py --duracao <秒> --resolucao <WxH>
python3 SKILL_DIR/scripts/folha.py                 # final/folha-final.jpg: 各シーンの1フレーム

validar.py が PASSOU と表示し、あなたが final/folha-final.jpg を目視確認(文字が判読可能、文字の誤りなし、すべてのパネルでスタイルが統一されている)した後にのみ、「完了」 と言ってください。失敗した場合は、不足している点を伝えてください。

ステップ10 — スキルの改善

動画ごとに、references/licoes.md に(1項目1行で)何が問題だったか、それを防ぐためのルールを書き留めてください。スタイルまたはストーリーボードのルールに関するものであれば、プロンプトだけでなく estilo.md/regras-storyboard.md も変更してください。

関連スキル