Communitygithub.com

reel-critic

完成した9:16リール(TikTok、Instagram Reels、YouTube Shorts)を投稿前にレビューし、修正を繰り返して合格させるスキルです。尺、フォーマット、ラウドネス、音声タイミング、声色バランス、フックの動き、静止伸び、ハードカットを測定し、台詞とスクリプトの一致を確認。さらにClaudeがコンタクトシートを確認してフレーミングやキャプション帯・セーフゾーンの問題を指摘します。

reel-critic とは?

このスキルは、9:16形式のリール動画(TikTok、Instagram Reels、YouTube Shorts)の品質保証を自動化します。投稿前に尺(40~68秒)、解像度(1080x1920、30fps)、ラウドネス(-11.5~-8.5 LUFS、-1 dBTP以内)、音声タイミング(最初の単語が0.3秒以内、無音ギャップ0.9秒以内)、声色バランス(発話がBGM/SFXより9dB以上)、フックの動き(最初の0.5秒に動きがある)、静止伸び(2秒以上フレームが変わらない部分がない)、ハードカット(最大2回)、台詞とスクリプトの一致(単語誤り率8%以下)などをチェックします。さらに、Claudeが1秒ごとのコンタクトシートを確認し、キャプション帯(y1250~1420)やセーフゾーン(x100~980、y220~1500)から被写体がはみ出していないか、フレーム端で切れていないか、プロップがレンズを塞いでいないか、モンゴル語リールで英語テキストが表示されていないか、台詞と映像が一致しているか、破損フレーム(黒、テクスチャ欠落、浮遊キャラクターなど)がないかをチェックします。失敗した箇所だけを最大3ラウンドまで修正し、最後にキャプションと英語のハッシュタグを生成してユーザーに提示します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atuuuuuuu/reel-critic/tree/HEAD

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

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

ドキュメント

/reel-critic

リールは合格するまで完成しません。make.sh が <reel>/<name>.mp4 を書き出した後にこれを実行してください。 PY はスティックマンキットのPython(numpy)です:PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python"。CRITIC="<base directory of this skill>"。

1. 言葉

最終mp4を文字起こしします:bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng](ElevenLabs Scribe via Composio、audio/stt_final.json に書き出し)。 Composio ElevenLabsのクォータが空の場合は、ElevenLabs Webアプリ(Speech to Text、Export JSON with timestamps)でmp4を文字起こしし、audio/stt_final.json として保存してください。Whisperはモンゴル語に弱いため、モンゴル語リールには使用しないでください。

2. 測定

"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] により <reel>/critic/report.md、report.json、critic/sheets/sheet_NN.jpg が書き出されます(1秒1フレーム、1シートあたり10フレーム;シートNNのフレームiは約 NN*10 + i 秒)。終了コード0は、測定されたすべてのチェックが合格したことを意味します。しきい値は rules.json にあります。

チェックルールやり直し手順
尺40~68秒スクリプト
サイズ、fps、コーデック1080x1920、30 fps、h264 + aacレンダリング/マスター
ラウドネス、トゥルーピーク-11.5~-8.5 LUFS、<= -1 dBTPマスター
音声開始最初の単語が0.3秒以内音声
音声ギャップ台詞間の無音が0.9秒以内音声
声色バランス発話がポーズ(音楽+SFX)より9 dB以上大きいミックス
フックの動き最初の0.5秒に動きがあるカメラ
映像変化の継続性フレームがほとんど変わらない2秒以上の伸びがないカメラ
ハードカット最大2回(ホイップグライドはカットに含まない)カメラ
台詞とスクリプトの一致キャプション置換後、単語誤り率 <= 8%音声

3. 見た目

すべてのコンタクトシートを読んでください(スタック:ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N)。シアンのボックス:セーフゾーン(x 100~980、y 220~1500)。黄色の帯:キャプション帯(y 1250~1420)。次の場合にリールを不合格とします。

  • 顔またはビートのキープロップがキャプション帯の下、またはセーフゾーンの外にある。
  • 被写体がフレーム端で切れている、またはレンズに近いプロップが被写体を覆っている。
  • サインボードやタイトルカードのテキストがキャプションで覆われている、またはモンゴル語リールに英語テキストが表示されている。
  • その瞬間の台詞の内容を映像が示していない(各フレームのキャプション単語を確認)。
  • 破損フレーム:黒、テクスチャ欠落、キャラクターが浮いている、床に沈み込んでいる。 ホイップグライドの途中のフレームはぼけていたり、空の地面が写っていたりしても問題ありません。各発見事項を時間とやり直し手順とともに report.md の ## Picture に記録してください。

4. 判定と修正ループ

手順2が終了コード0で、手順3に発見事項がなく、手順1の差分リストに実際に音声が間違えた単語がない(STTのスペリングミスはカウントしない)場合のみPASSとします。 FAILの場合、失敗した部分だけをやり直し、手順1~3を再度実行します。3ラウンド後に停止し、まだ失敗している内容をユーザーに表示します。

  • カメラ/フレーミングが特定の時間に問題:web/shots.js を編集し、render.js stills で確認後、bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...>(その時間を含むショットのみ再レンダリング、再結合、リマスター)。多くのショットで見られるセットの変更には完全な make.sh が必要です。
  • 音声ライン:そのラインを再録音(stickman3dmn:retake.py またはElevenLabs Webアプリ)、単語時間を再構築、make.sh <reel> keep。
  • ミックス/ラウドネス:audio.py を編集、AUDIO_ONLY=1 make.sh <reel> keep。
  • スクリプト/尺:ユーザーに戻す。スクリプトはユーザーが承認するものです。

5. 実際の数値から学ぶ

python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json により、Composio経由でInstagramリールのインサイト(再生数、シェア数、保存数、平均視聴時間)とTikTok動画の統計を取得します。接続されていないプラットフォームはスキップします(composio link instagram、composio link tiktok;Instagramインサイトにはビジネスまたはクリエイターアカウントが必要)。投稿が10件以上になったら、上位3分の1と残りを比較し(視聴時間、尺、フックタイプ)、ユーザーに提案する rules.json の変更案を作成してから適用します。

6. 引き継ぎ

ユーザーに次の情報を提供します:mp4パス、尺、測定ラウドネス、判定テーブル、修正済みの画像発見事項、およびリールの言語によるTikTok、Instagram、YouTube Shorts向けキャプション(3~5個の英語ハッシュタグ付き。Herveeチャンネルでは常に #whatif、トピックタグ例 #mongolia #ulaanbaatar、TikTokでは #fyp、YouTubeでは #shorts)。ユーザーは手動で投稿します。

ルールの由来

README.md を参照:保持率とフックの研究、セーフゾーン測定、調査された自動化ツールについて説明しています。

関連スキル