claude-video（/watch）— 讓 Claude「看」影片的 Claude Code Skill

2026 年 7 月 6 日共 800 字

GitHub Claude Code Skill 影片分析 ffmpeg yt-dlp

來源：GitHub https://github.com/bradautomates/claude-video

claude-video 是一個 Claude Code Skill（指令 /watch），讓 AI 具備「看影片」的能力：自動下載影片、抽出畫面 frame、抓逐字稿，再交給 Claude 分析。你可以問它影片某個時間點發生什麼、幫你摘要內容，或從螢幕錄影裡診斷問題。MIT 授權，作者 bradautomates。

運作方式
先抓字幕；需要時用 yt-dlp 下載影片、用 ffmpeg 依場景自動縮放抽出 JPEG 畫面、產生帶時間戳的逐字稿（原生字幕優先，沒有才用 Whisper API 補），最後把畫面與逐字稿一起交給 Claude 回答。

安裝方式
Claude Code（推薦）：在 Claude Code 內輸入 /plugin marketplace add bradautomates/claude-video，再 /plugin install watch@claude-video。
跨 agent（Codex／Cursor／Copilot／Gemini CLI 等）：npx skills add bradautomates/claude-video -g。
手動：git clone 後把 skills/watch 符號連結到 ~/.claude/skills/watch。

前置需求
yt-dlp、ffmpeg、python3；轉逐字稿若影片沒有字幕，需在 ~/.config/watch/.env 設定 Groq 或 OpenAI API key。首次執行會自動檢查依賴，macOS 會用 brew 自動補裝。

使用範例
/watch 影片網址影片30秒發生什麼？
/watch 本機錄影.mp4 UI 什麼時候壞掉？

技術細節：Python 94.9% + Shell 5.1%，核心依賴 yt-dlp／ffmpeg／Whisper API，MIT License。