mason0510/video-frame-analysis-skills

video-frame-analysis

概要

「ローカル動画 → ffprobe → タイムスタンプ付きフレーム抽出 → コンタクトシート → OCR → summary.txt / ocr.json 出力」を、再利用可能な軽量スキルとして固定化します。

Codex、Claude Code、OpenCode などのエージェントが、ローカルのデモ動画、スクリーンレコーディング、競合ページのウォークスルーを処理するのに適しています。

使用するタイミング

以下の場合に適しています：

• ユーザーからローカル動画が渡され、製品のどこまで実装されているかを判断する必要がある
• 動画を、確認可能なフレーム画像、OCRテキスト、サマリーファイルに分割する必要がある
• まず軽量な証拠抽出を行い、その後人間による判断やさらなる分析を行う必要がある
• 毎回手動で ffmpeg / tesseract コマンドを組み立てるのを避けたい

以下の場合には適していません：

• ネットワーク上の動画のダウンロード
• バッチ動画キュー
• リアルタイムストリーム解析
• GUI または Web プラットフォーム
• 高負荷な動画理解モデル

クイックスタート

bash scripts/video-frame-analysis.sh /path/to/demo.mp4 ./out/demo-analysis

デフォルトの出力：

• ffprobe.txt
• frame_*.jpg
• contact.png
• ocr.txt
• ocr.json
• summary.txt

インストール

Codex / Claude Code / OpenCode に直接インストールすることを推奨します：

npx skills add https://github.com/mason0510/video-frame-analysis-skills -g --all

インストール後、エージェントセッションを再起動し、必要に応じて本スキルを呼び出します。

入力 / 出力

入力

• ローカル動画のパス
• 出力ディレクトリのパス

出力

• 動画メタ情報
• タイムスタンプ付きフレーム画像
• コンタクトシート
• OCR テキスト
• OCR JSON
• サマリーテキスト

設定

FRAME_INTERVAL_SECONDS=5 FRAME_WIDTH=420 OCR_LANG=eng \
  bash scripts/video-frame-analysis.sh ./demo.mp4 ./out/demo

変数	説明	デフォルト値
FRAME_INTERVAL_SECONDS	フレーム抽出間隔（秒）	8
FRAME_WIDTH	単一フレームの幅	360
OCR_LANG	OCR 言語指定	chi_sim+eng

プロジェクトファイル

• scripts/video-frame-analysis.sh：メインスクリプト
• tests/test_video_frame_analysis.sh：最小限の閉じたテスト
• references/output-format.md：出力ディレクトリの説明
• agents/openai.yaml：OpenAI/Codex 側の表示情報

よくある間違い

• 高負荷な動画理解モデルと誤解する
• フレーム抽出間隔を短くしすぎて OCR ノイズが増大する
• コンタクトシートを無視し、OCR テキストだけに注目する
• マシンに ffmpeg / tesseract がインストールされているか確認を忘れる