Communitygithub.com

bg-szy/TOP-SKILLS

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

TOP-SKILLS とは?

このスキルは、FFmpegとOpenAIのWhisperモデルを統合した、動画処理のための包括的なCLIツールです。動画からの音声抽出、MP4やWebM形式への変換、Whisperによる音声文字起こしを、単一のスクリプト `scripts/video_processor.py` を通じて提供します。主なユースケースとしては、古いカメラの動画をMP4に変換する、講義動画から文字起こしを生成する、Webサイト向けにWebM動画と字幕を作成する、特定の言語のインタビューを高精度で文字起こしする、複数の動画をバッチ処理する、などがあります。スクリプトはPEP 723に準拠しており、click(CLIフレームワーク)とffmpeg-python(FFmpegのPythonラッパー)に依存しています。ユーザーは、`uv run` を使って簡単にコマンドを実行でき、Whisperのモデルサイズ(tinyからlargeまで)や出力フォーマット(txt、srt、vtt、json)などを柔軟に選択できます。エラーハンドリングも充実しており、一時ファイルの自動クリーンアップや依存関係のチェックが行われます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/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はWeb再生とストリーミングに最適化されています

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. Web形式に変換
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字幕形式(Web標準)
  • 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:字幕付きのWeb最適化動画を作成

ユーザーリクエスト:

この動画を字幕付きでウェブサイトに載せたいんですけど、手伝ってもらえますか?

あなたの対応:

  1. Web最適化のために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(Web最適化動画)
    • 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(Web最適化)に変換
  • 文字起こし:複数の出力フォーマットでの音声認識
  • 柔軟性:モデル選択、言語、出力フォーマットのCLI引数

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

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

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", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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

関連スキル