Communitygithub.com

aiskillstore/marketplace

處理影片檔案,包含音訊擷取、格式轉換(mp4、webm)以及 Whisper 語音轉文字。當使用者提到影片轉換、音訊擷取、轉錄、mp4、webm、ffmpeg 或 Whisper 轉錄時使用。

marketplace 是什麼?

這個技能提供了一個統一的影片處理介面,整合了 FFmpeg 和 OpenAI Whisper 模型,讓開發者或 AI 代理能夠執行音訊擷取、格式轉換和語音轉文字等常見作業。它支援所有主流平台(macOS、Linux),並透過一個基於 CLI 的 Python 指令碼來運作,該指令碼使用 `uv run` 執行,提供 `extract-audio`、`to-mp4`、`to-webm` 和 `transcribe` 等指令。使用者可以靈活地調整輸出格式、編解碼器、轉碼預設以及 Whisper 模型大小(從 tiny 到 large),以在速度與準確度之間取得平衡。此技能特別適合需要處理大量影片素材、建立字幕檔案(SRT/VTT)或為網頁播放最佳化影片的情境。內建的錯誤處理與自動清理暫存檔的功能,讓整個工作流程既可靠又易於整合到更大的自動化管道中。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影片處理器

使用說明

此技能提供影片處理工具,包括音訊擷取、格式轉換以及使用 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.

相關技能