Communitygithub.com

reel-tela-viva

Estilo Tela Viva. アニメーション式9:16リールを「画面上のチュートリアル」スタイル(汎用ウィンドウ、番号付きステップ、単語ごとのキャプション)で作成します。ブランドカラーと@を使用。「Tela Viva」または画面やアプリを使ったチュートリアル形式のショート動画がリクエストされたときに使用します。

reel-tela-viva とは?

このスキルは、与えられたテーマを元に、コードベース(Python + ffmpeg)で「チュートリアル形式」の9:16縦長リール動画(1080×1920、30fps、MP4)を生成します。上部に進捗バーとステップ番号、中央に汎用的なウィンドウ(テキスト入力、応答表示、マーカー、機密データの黒塗りなど)を配置し、下部には単語ごとにキャプションが表示されます(その時点で発話されている単語がブランドカラーで強調されます)。最後に「フォローしてね」カードが表示されます。AI動画生成ではなく、あらかじめ用意されたスクリプトとアセットを用いて高速にレンダリングします(40秒のリールなら1分未満で完成)。対応プラットフォームはClaude Code(このスキル定義自体です)であり、ユーザーが指定したテーマ、ブランドカラー、@に基づき、まずロケーションファイル(roteiro.json)を書き起こし、プレビュー確認後、最終動画とナレーションガイドを生成します。音声ファイルがあれば自動で映像と同期させることも可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adnytamires/skills-reels-video/tree/HEAD/reel-tela-viva

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

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

ドキュメント

Tela Viva: アニメーション式チュートリアルリール

3スタイルキット: ユーザーがスタイルを指定せずにリールを依頼し、かつスキル「Modo 8-Bit(ピクセルアート)」と「Hora Dourada(チュートリアル用フラットアイコン)」も利用可能な場合は、まず3つのスタイルのうちどれが良いか尋ねてください。

このスキルは、テーマをチュートリアル形式の縦長リール(1080×1920、30fps、MP4)に変換します:

  • 上部にプログレスバーとステップ番号(短いタイトル付き)。
  • 中央に、汎用的でブランドのないウィンドウが「動作」している様子(テキスト入力、応答表示、マーカー、機密データの黒塗りなど)。
  • 下部に、単語ごとのキャプション:発話中の単語がブランドカラーで表示されます。
  • 最後に「フォローしてね」カード。

動画はコード(Python + ffmpeg)で生成されます。AI動画生成は使用しません。40秒のリールなら1分未満で完成します。

常にユーザーの言語(通常はポルトガル語)で応答してください。

ステップ1. リクエストを理解する(1回の質問で、不足している情報をすべて尋ねる)

ユーザーがまだ言及していないことだけを、一度に質問します:

  1. テーマ: 視聴者が何を学んだり試したりするのか?ユーザーがすでにナレーションのテキストを提供している場合は、そのテキストを使用します。
  2. ブランド: メインカラー(16進数、例:#7C3AED)とプロフィールの@。回答がない場合は、紫色 #7C3AED と @seuperfil を使用し、その旨を伝えます。

ユーザーが「お任せで」と言った場合は、質問せずにデフォルト値を使用し、使用した値を伝えます。

ステップ2. スクリプトを書く

roteiro.json ファイルを作成します(以下の形式; exemplos/roteiro-exemplo.json にテンプレートがあります)。

効果的な構成(5~8シーン、30~60秒):

  1. フック(記号 !):視聴者が共感する状況(ナレーション最大10語)。
  2. 番号付きステップ(記号 1、2、3...):シーンごとに1つのアクション、ウィンドウにアクションを表示。
  3. 注意(ステップの1つに含めることも可):結果を確認し、機密データを貼り付けない。
  4. コールトゥアクション(記号 ✓):例:「プロンプトはキャプションに」+ 付箋(nota)。
  5. 最後("tipo": "final"):「もっと見たい方はフォローを…」。

コンテンツルール:

  • タイトルは最大6語。1~2語を *アスタリスク* で強調。
  • ナレーション:約毎秒2.3語。各シーンの長さはナレーションから算出されます。
  • 架空のデータ、名前、企業(「Aさん」「サプライヤー」)を使用し、データが含まれるシーンには "exemplo": true をマーク。
  • 実際のツールの名前、ロゴ、画面を配置しないでください。ウィンドウは汎用的です(「AIアシスタント」「スプレッドシート」「受信箱」)。
  • 機能、数式、数値、結果をでっち上げないでください。スクリプトがツールの機能に言及する場合は、公式ソース(Web検索など可能なら)で確認し、確認したことをユーザーに伝えてください。確認できない場合は、その旨を伝えてください。
  • 大げさな約束(「10時間節約」「もう二度と…」)はしない。

ステップ3. 動画生成前のプレビューフレーム

各シーンの中間時間を指定してプレビューを実行します(時間は出力の先頭に表示されます):

python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32

saida/previa_grade.jpg を開いて確認:

  • ウィンドウからはみ出ているテキストがないこと。
  • 2行を超えるタイトルがないこと。
  • マーカーと黒塗りが正しい位置にあること。

必要に応じてJSONを調整し、繰り返します。その後、ユーザーにプレビューグリッドとスクリプトを表(シーン、表示内容、ナレーション、時間)で見せ、動画を生成しても良いか尋ねます。

ステップ4. 動画を生成する

python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --nome meu-reel

このコマンドで生成されるもの:

  • saida/meu-reel-sem-voz.mp4:落ち着いたBGMとタイピング音(スクリプト自作、サードパーティの音楽は不使用)。
  • saida/guia-narracao.txt:ナレーションテキストのみ、シーンごとに1段落。
  • saida/tempos.txt:各シーンの開始時間と終了時間。

--sem-musica でBGMなしの動画を生成します。

ユーザーへの納品物:

  • 動画
  • ナレーションガイドと時間ファイル
  • 投稿用キャプション(フック、手順、プロンプト全文があれば、「これは例です。」、ハッシュタグ3~5個)

送信前に、最終的なMP4の4~5フレームを確認してください(ffmpegで抽出)。

ステップ5. 音声(ユーザーが音声ファイルを送ってきた場合)

ユーザーはガイドに従ってナレーションを録音します(スマホでも、AI音声でも、好みに応じて)。音声ファイルを受け取ったら:

python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --nome meu-reel --audio /path/to/voz.m4a
  • タイムマークがない場合、スクリプトは各シーンの単語数に比例して、音声全体にシーンを均等に配置します。
  • 正確に同期するには、JSONに "marcas_audio": [0, 7.8, 15.2, ...] として、録音内で各シーンが始まる秒数を設定します。ユーザーがこれらの時間を伝えるか、単語単位のタイムスタンプが付いた文字起こしツールがあれば、ファイルを聞いて確認できます。
  • 出力は saida/meu-reel-com-voz.mp4 で、BGMは音声の下で小さくなります。

別の方法:ユーザーが自分で動画編集ソフト(CapCut、InShot、Instagramのエディター)で、音声なしの動画に音声を追加することもできます。

納品時の注意: AIで生成された音声、画像、動画が含まれる場合、ユーザーは投稿時にAIラベルを付ける必要があります。

roteiro.json の形式

{
  "marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "プロフィールの短いフレーズ"},
  "palavras_por_segundo": 2.3,
  "cenas": [
    {"selo": "!", "titulo": "受信箱が*いっぱい?*", "narracao": "...", "exemplo": false,
     "duracao": 6.5,
     "janela": {"tipo": "lista", "...": "..."},
     "nota": {"texto": "プロンプトはキャプションへ ↓", "sub": "保存", "em": 0.4},
     "pilula": {"texto": "オフにできる", "em": 0.3, "y": 0.4}}
  ]
}
  • duracao は省略可能:指定がない場合はナレーションから長さを算出します。
  • 最後のカードには@の頭文字が表示されます。ユーザーから依頼がない限りマスコットは入れないでください。
  • nota(付箋)と pilula(フローティングラベル)は省略可能です。em の値はシーン内で表示されるタイミングの割合(0~1)です。
  • 色は、白背景でテキストが読みにくい場合に自動的に暗くされます。

ウィンドウ内テキストのマークアップ: [[テキスト]] はシーン中に表示されるマーカーになります。{{テキスト}} はテキストを隠す黒い帯(機密データ)になります。

tipo用途フィールド
lista受信箱、タスクリスト、ファイルtitulo, itens([送信者、件名、プレビュー])、nao_lidas(インデックス)、destaque(インデックス)、tremer、destaque_em
texto会話、メモ、ドキュメントtitulo、resumo({titulo, linhas})、resumo_animado、mensagens([{autor, texto}])、marcar_em、tarjar_em、etiquetas(✓付きピル)、etiquetas_em
chatAIアシスタント(暗いウィンドウ)titulo、prompt(タイプ入力)、resposta(行のリスト、省略可)、caracteres_por_segundo
escreverメールやメッセージの返信titulo、texto(タイプ入力)、botao
planilhaシンプルな表titulo、colunas、linhas、coluna_destaque、formula(省略可:確認済みの数式のみ)、revelar_ultima
cartao新着情報、ルール、ハイライトまとめselo、titulo(*強調* 可)、texto、fonte(情報の出典)
final「フォローしてね」カードbio、botao、clique_em

よくある問題

  • 「ffmpeg が見つかりません」: スクリプトは imageio-ffmpeg を pip で自動インストールしようとします。失敗した場合は、pip install imageio-ffmpeg を実行してください(必要に応じて --break-system-packages 付き)。
  • テキストがウィンドウから切れたりはみ出したりする: テキストを短くする、2つのメッセージに分割する、リスト項目を減らす(約5行まで収まります)。
  • キャプションが速すぎる: シーンの duracao を増やすか、ナレーションの単語数を減らします。
  • フォント: Inter と JetBrains Mono(SIL Open Font ライセンス、ファイルは assets/fonts にあります)。

Individual skills in this repo

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

関連スキル