動画の全体像を並べて確認するコンタクトシート

Video Contact Sheets with Seek-Time Manifests

動画から等間隔にコマを取り出し、一覧画像にまとめます。コマ数・配置・JPEG/PNGを選び、抽出位置をJSONで残せます。

ClaudeHermes AgentCodexCursorMIT(改変・再配布・商用利用可)Python

できること

動画の長さに応じて等間隔の位置からコマを抽出し、JPEGまたはPNGの一覧画像を作ります。コマ数、列数、行数、各コマの幅を指定でき、任意で抽出位置の秒数を画像に表示します。manifest.jsonには各コマの行・列と抽出を要求した秒数が残るため、素材の見直しや編集前の共有に使えます。画像の処理にはFFmpegだけを使います。

使い方

ZIPを展開し、Claude、Hermes Agent、Codex、CursorにSKILL.mdを読み込ませます。手元の動画と新規出力フォルダーを指定し、まず--dry-runで枚数や配置を確認します。実行後は一覧画像とJSONを確認してください。

必要な環境

Python 3.10以降と、別途導入したFFmpeg・ffprobeが必要です。ラベルを付ける場合はdrawtextフィルターと利用可能なフォントが必要です。実行ファイルは同梱していません。

注意点

既存のフォルダーや原本への出力は拒否します。上限は6時間、100コマ、画像全体6400万画素です。時刻は要求したシーク位置であり、デコード後の正確なフレーム時刻の保証ではありません。末尾の余ったマスは黒になります。通信やアップロードは行いません。

English description

Sample evenly spaced frames into a JPEG or PNG contact sheet with optional seek-time labels and a JSON timestamp manifest.

What it does

Samples a local video at evenly spaced seek positions, creates a JPEG or PNG tiled sheet, and records row, column, and requested seconds in JSON. Choose sample count, grid, thumbnail width, and optional time labels. FFmpeg handles all image processing.

How to use

Extract the ZIP and ask Claude, Hermes Agent, Codex, or Cursor to read SKILL.md. Supply local input and a new output directory. Use --dry-run first, then inspect the sheet and manifest.

Requirements

Python 3.10+, FFmpeg, and ffprobe installed separately. Labels need the drawtext filter and an available font. No external Python packages are required.

Caveats

Refuses existing output directories. Limits are six hours, 100 samples, and 64 million sheet pixels. Timestamps are requested seek positions, not verified decoded-frame PTS. Spare cells are black. No uploads, downloads, scene detection, or content understanding. Failed runs can leave partial output; choose a new directory to retry.

インストール方法

  1. ダウンロードしたZIPを展開します(中に video-contact-sheet/ フォルダと SKILL.md があります)。
  2. フォルダごと、使うエージェントのスキル置き場にコピーします。
    • Claude:~/.claude/skills/(プロジェクト単位なら .claude/skills/)
    • Hermes Agent:~/.hermes/skills/
    • Codex:~/.agents/skills//Cursor:~/.cursor/skills/
    • Claude アプリ(claude.ai):「カスタマイズ → スキル」からZIPをアップロード
  3. エージェントを再起動し、スキル一覧に表示されることを確認します。

Windows・Mac 別、エージェント別のインストール手順

出品者

動画編集が仕事

動画編集の準備から仕上がりの確認まで、毎日の作業を支援するスキルを制作しています。切り出し・字幕づくり・音声調整・文字起こしを、元の素材を残しながら進められるようにします。

出品スキル 10 件

出品者のプロフィールとスキル一覧