Communitygithub.com

ビデオプロセッサー

動画ファイルの音声抽出、フォーマット変換(mp4、webm)、およびWhisperによる文字起こしを行います。ユーザーが動画変換、音声抽出、文字起こし、mp4、webm、ffmpeg、またはwhisperについて言及したときに使用します。

ビデオプロセッサー とは?

このスキルは、FFmpegとOpenAIのWhisperモデルを統合した強力な動画処理ユーティリティを提供します。主な機能には、動画ファイルからの音声抽出、MP4やWebMへのフォーマット変換、そしてWhisperによる高精度な音声文字起こしが含まれます。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェント環境で、`scripts/video_processor.py`という単一のスクリプトを通じてすべての操作を実行できます。このスキルは、動画処理の専門知識がなくても、簡単なCLIコマンドで複雑なマルチメディア処理を実現できる点が優れています。例えば、講義動画を文字起こしたり、ウェブ配信用に最適化されたWebMファイルを生成したり、複数の動画をバッチ処理したりすることができます。内部では、FFmpegが音声抽出とフォーマット変換を担当し、Whisperが抽出された音声データをテキストに変換するという明確な役割分担がなされています。また、エラーハンドリングも充実しており、依存関係のチェックや一時ファイルの自動クリーンアップなど、安定した運用をサポートします。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/aiskillstore/marketplace/tree/HEAD/skills/egadams/video-processor

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

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

ドキュメント

ビデオプロセッサー は何をしますか?

手順

このスキルは、FFmpegとOpenAIのWhisperモデルを使用した、音声抽出、フォーマット変換、および音声文字起こしを含む動画処理ユーティリティを提供します。

前提条件

必要なツール(環境にインストールされている必要があります):

  • FFmpeg:動画/音声処理のためのマルチメディアフレームワーク

    # macOS
    brew install ffmpeg
    
    # Ubuntu/Debian
    apt-get install ffmpeg
    
    # インストール確認
    ffmpeg -version
    
  • OpenAI Whisper:音声認識モデル

    # pipでインストール
    pip install -U openai-whisper
    
    # インストール確認
    whisper --help
    

Pythonパッケージ(PEP 723によりスクリプトに含まれています):

  • click(CLIフレームワーク)
  • ffmpeg-python(FFmpeg用Pythonラッパー)

ワークフロー

すべての動画処理タスクには、scripts/video_processor.pyスクリプトを使用します。このスクリプトは、以下のコマンドを備えたシンプルなCLIを提供します:

1. 動画から音声を抽出

動画ファイルから音声トラックを抽出します:

uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio input.mp4 output.wav

オプション:

  • --format:出力音声フォーマット(デフォルト: wav)。対応: wav, mp3, aac, flac
  • 出力は文字起こしやスタンドアロン音声での使用に適しています

2. 動画をMP4に変換

任意の動画ファイルをMP4形式に変換します:

uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 input.avi output.mp4

オプション:

  • --codec:ビデオコーデック(デフォルト: libx264)。一般的なオプション: libx264, libx265, h264
  • --preset:エンコード速度/品質プリセット(デフォルト: medium)。オプション: ultrafast, fast, medium, slow, veryslow

3. 動画をWebMに変換

任意の動画ファイルをWebM形式(ウェブ最適化)に変換します:

uv run .claude/skills/video-processor/scripts/video_processor.py to-webm input.mp4 output.webm

オプション:

  • --codec:ビデオコーデック(デフォルト: libvpx-vp9)。オプション: libvpx, libvpx-vp9
  • WebMはウェブ再生とストリーミングに最適化されています

4. Whisperで音声を文字起こし

OpenAIのWhisperモデルを使用して、音声ファイルまたは動画ファイルをテキストに変換します:

# 動画ファイルを文字起こし(音声は自動的に抽出されます)
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe input.mp4 transcript.txt

# 音声ファイルを直接文字起こし
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe audio.wav transcript.txt

オプション:

  • --model:Whisperモデルサイズ(デフォルト: base)。オプション:
    • tiny:最速、最低精度(約1GB RAM)
    • base:高速、良好な精度(約1GB RAM)[デフォルト]
    • small:バランス良好(約2GB RAM)
    • medium:高精度(約5GB RAM)
    • large:最高精度、最低速(約10GB RAM)
  • --language:言語コード(デフォルト: 自動検出)。例: en, es, fr, de, zh
  • --format:出力フォーマット(デフォルト: txt)。オプション: txt, srt, vtt, json

文字起こしワークフロー:

  1. 入力が動画の場合、FFmpegが音声を一時的なWAVファイルに抽出します
  2. Whisperが音声ファイルを処理します
  3. 文字起こし結果が要求されたフォーマットで保存されます
  4. 一時ファイルは自動的にクリーンアップされます

5. 複合ワークフロー例

動画をエンドツーエンドで処理する:

# 1. 分析用に音声を抽出
uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav

# 2. SRT字幕に文字起こし
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 lecture.srt --format srt --model small

# 3. ウェブ形式に変換
uv run .claude/skills/video-processor/scripts/video_processor.py to-webm lecture.mp4 lecture.webm

主要な技術的詳細

FFmpegとWhisperの統合:

  • FFmpegはそれ自体では音声を文字起こししません。外部の文字起こしのために音声を準備します。
  • ワークフローは次のとおりです:音声抽出(FFmpeg)→ 文字起こし(Whisper)→ オプションで動画と再統合
  • FFmpegは、リアルタイム処理のために音声を直接Whisperにパイプすることもできます(高度なユースケース)

文字起こし用の音声フォーマット:

  • WhisperはWAVまたはMP3形式で最適に動作します
  • サンプルレート:16kHzが最適です(スクリプトが自動的に変換します)
  • スクリプトはWhisperに最適な設定で音声を抽出します

出力フォーマット:

  • txt:プレーンテキストの書き起こし
  • srt:SubRip字幕形式(タイムスタンプを含む)
  • vtt:WebVTT字幕形式(ウェブ標準)
  • json:単語レベルのタイムスタンプを含む詳細なJSON

エラーハンドリング

スクリプトには包括的なエラーハンドリングが含まれています:

  • 入力ファイルの存在を検証
  • FFmpegとWhisperがインストールされているか確認
  • 依存関係が不足している場合、明確なエラーメッセージを表示
  • エラー発生時の一時ファイルクリーンアップを処理

パフォーマンスのヒント

  • クイックドラフトにはtinyまたはbaseモデルを使用
  • 本番用の文字起こしにはsmallまたはmediumを使用
  • 最大の精度が必要な場合にのみlargeを使用
  • 長い動画の場合は、最初に音声を抽出し、セグメントごとに文字起こしすることを検討
  • VP9を使用したWebM変換は時間がかかりますが、より小さなファイルを生成します

例

例1:動画をMP4に簡単変換

ユーザーリクエスト:

古いカメラのAVIファイルがあるんだけど、MP4に変換してくれない?

あなたの対応:

  1. デフォルト設定でto-mp4コマンドを使用:
    uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 old_video.avi output.mp4
    
  2. 変換が正常に完了したことを確認
  3. 出力ファイルの場所をユーザーに伝える

例2:音声抽出と文字起こし

ユーザーリクエスト:

講義の動画を録画したんだけど、書き起こしが必要なんだ。音声を抽出して文字起こししてくれない?

あなたの対応:

  1. まず音声を抽出:
    uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav
    
  2. 次にbaseモデルを使用して文字起こし(速度と精度の良いバランス):
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 transcript.txt --model base
    
  3. ユーザーにtranscript.txtファイルを共有

例3:字幕付きウェブ最適化動画の作成

ユーザーリクエスト:

この動画をウェブサイトに字幕付きで載せたいんだけど、手伝ってくれる?

あなたの対応:

  1. ウェブ最適化のためにWebMに変換:
    uv run .claude/skills/video-processor/scripts/video_processor.py to-webm presentation.mp4 presentation.webm
    
  2. SRT字幕ファイルを生成:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe presentation.mp4 subtitles.srt --format srt --model small
    
  3. ユーザーに以下のファイルがあることを伝える:
    • presentation.webm(ウェブ最適化動画)
    • subtitles.srt(埋め込み用字幕ファイル)

例4:言語指定による高品質文字起こし

ユーザーリクエスト:

出版用に正確な書き起こしが必要なスペイン語インタビュー動画があるんだ。

あなたの対応:

  1. 最高の精度を得るために、より大きなモデルと言語を指定:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.txt --model medium --language es
    
  2. オプションでレビュー用にSRTを作成:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.srt --format srt --model medium --language es
    
  3. ユーザーと書き起こし結果を確認し、必要に応じて修正する

例5:複数動画のバッチ処理

ユーザーリクエスト:

トレーニング動画が入ったフォルダがあるんだけど、全部WebMに変換して文字起こししてほしい。

あなたの対応:

  1. ディレクトリ内のすべての動画ファイルをリストアップ:
    ls training_videos/*.mp4
    
  2. 各動画ファイルに対して、変換と文字起こしを実行:
    # 各動画について: video1.mp4, video2.mp4 など
    uv run .claude/skills/video-processor/scripts/video_processor.py to-webm training_videos/video1.mp4 output/video1.webm
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe training_videos/video1.mp4 output/video1.txt --model base
    
    # 各ファイルに対して繰り返し
    
  3. すべての変換と文字起こしが完了したことを確認
  4. 出力ファイルのサマリーを提供

サマリー

video-processorスキルは、一般的な動画処理タスクのための統合インターフェースを提供します:

  • 音声抽出:さまざまな形式で音声トラックを抽出
  • フォーマット変換:MP4(汎用)またはWebM(ウェブ最適化)に変換
  • 文字起こし:複数の出力形式に対応した音声認識
  • 柔軟性:モデル選択、言語、出力形式のためのCLI引数

すべての操作は、適切なデフォルト値と包括的なエラーハンドリングを備えた、単一の十分に文書化されたスクリプトを通じて処理されます。

Individual skills in this repo

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

aiskillstore/marketplace

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

aiskillstore/marketplace

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

aiskillstore/marketplace

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

aiskillstore/marketplace

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

aiskillstore/marketplace

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

aiskillstore/marketplace

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

aiskillstore/marketplace

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

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.

関連スキル