Communitygithub.com

JantonioFC/skillsbank

MP4動画から設定可能な間隔でキーフレームを抽出し、Tesseract OCRを実行して、動画メタデータとタイムスタンプ付きテキストトランスクリプトを含む構造化されたMarkdownレポートを生成します。

skillsbank とは?

このスキルは、MP4ビデオファイルから設定可能な時間間隔でキーフレームを自動抽出し、各フレームにTesseract OCRを適用してテキスト認識を行い、動画メタデータ(再生時間、解像度、コーデック)とフレームごとのOCR文字起こしをタイムスタンプ付きでまとめた構造化Markdownレポートを生成します。主にCodex CLI環境での使用を想定しており、ローカルマシンにFFmpegとTesseract OCRがインストールされている必要があります。このスキルは、プレゼンテーションや講義、スクリーンキャストなどの動画からテキスト情報を抽出したり、字幕のない動画から検索可能な文字起こしを作成する場合に役立ちます。フレーム抽出は時間ベースであり、シーンチェンジ検出は行わないため、短い間隔では重複フレームが発生する可能性がある点に注意が必要ですが、デフォルトの30秒間隔を適宜調整することで効率的な処理が可能です。すべての処理はローカルで完結し、ネットワークへのデータ送信は一切行わないため、セキュリティ面でも安心して利用できます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/skills/video-content-extractor

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

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

ドキュメント

Video Content Extractor(動画コンテンツ抽出ツール)

概要

MP4ビデオファイルから設定可能な時間間隔でキーフレームを自動抽出し、各フレームに対してOCRテキスト認識を実行し、構造化されたMarkdownレポートを生成します。レポートには、動画メタデータ(再生時間、解像度、コーデック)と、タイムスタンプ付きのフレームごとのOCR文字起こしが含まれます。

このスキルはCodex CLI向けに設計されており、ローカルマシンにFFmpegとTesseract OCRがインストールされている必要があります。

このスキルを使用するタイミング

  • 動画プレゼンテーション、講義、スクリーンキャストからテキストコンテンツを抽出する必要がある場合。
  • 字幕が埋め込まれていない動画ファイルから、検索可能な文字起こしを作成したい場合。
  • 動画コンテンツをプログラムで分析し、構造化されたサマリーを生成したい場合。
  • ユーザーが「画面に何が表示されているか読み取って」または「この動画からコンテンツを抽出して」と依頼した場合。

動作の仕組み

ステップ1: 動画メタデータの分析

スキルはffprobeを使用して、動画メタデータ(再生時間、解像度、フレームレート、コーデック情報、ファイルサイズ)を抽出します。

ステップ2: キーフレームの抽出

FFmpegを使用して、設定された間隔(デフォルト: 30秒ごと)でフレームをキャプチャします。各フレームはタイムスタンプ付きのJPEG画像として保存されます。

ステップ3: OCRテキスト認識

抽出された各フレームはTesseract OCRで処理されます。デフォルトのPSMモードで意味のあるテキストが返されない場合、自動ページセグメンテーションにフォールバックします。

ステップ4: Markdownレポートの生成

抽出されたすべてのデータが構造化されたMarkdownドキュメントにまとめられます。

使用例

例1: 基本抽出

エージェントプロンプト: video-content-extractor スキルを使用して、lecture.mp4 からコンテンツを抽出してください。

出力として lecture.md と lecture_frames/ ディレクトリが生成されます。

例2: カスタム間隔

パラメータ: video_path, output_dir, interval(秒), lang 英語のみのOCRで60秒ごとに抽出: python scripts/extract_video.py recording.mp4 ./output 60 eng

例3: バイリンガルコンテンツ

デフォルトの中語 + 英語OCRで抽出: python scripts/extract_video.py lecture.mp4 . 15 chi_sim+eng

ベストプラクティス

  • テキスト変更が頻繁な速いペースのコンテンツには、短い間隔(10~15秒)を使用します。
  • プレゼンテーションスライドやゆっくりした講義には、長い間隔(30~60秒)を使用して重複フレームを減らします。
  • 中国語コンテンツの場合は、Tesseract中国語言語パック(chi_sim)がインストールされていることを確認してください。

制限事項

  • FFmpegとTesseract OCRがインストールされ、PATHからアクセス可能である必要があります。
  • Tesseract OCRの精度は、動画品質、テキストサイズ、フォントの明瞭さに依存します。
  • オーディオの抽出や音声テキスト変換は行いません。
  • フレーム抽出は時間ベース(シーンチェンジベースではない)であるため、ほぼ同一のフレームが生成される可能性があります。
  • 短い間隔で大きな動画を処理すると、多くのフレームが生成されるため、十分なディスク容量を確保してください。

セキュリティと安全性に関する注意

  • このスキルはビデオファイルの読み取りと、抽出されたフレームおよびMarkdownレポートの書き込みのみを行います。
  • ネットワーク経由でデータを送信することは一切ありません。すべての処理はローカルで行われます。
  • FFmpegとTesseractは、固定された事前検証済みの引数で呼び出されます。
  • 元のビデオファイルを変更または削除することはありません。

よくある問題と解決策

  • 問題: Tesseractが文字化けしたテキストを返す 解決策: 正しい言語パックがインストールされていることを確認してください。tesseract --list-langs を実行して確認します。

  • 問題: FFmpegが「見つかりません」というエラーで失敗する 解決策: FFmpegがPATHに含まれていることを確認してください。ffmpeg -version を実行して確認します。

  • 問題: 大きな動画でOCRが遅い 解決策: interval パラメータを大きくして、処理するフレーム数を減らします。

関連スキル

  • @media-summarizer - ビジュアルおよびオーディオの手がかりを使用して動画コンテンツを要約します。
  • @document-ocr - 動画処理を伴わない静止画像やスキャン文書のOCRに使用します。

Individual skills in this repo

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

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

関連スキル