英文版：
SKILL.en.md
media — 影片 / 音訊 / 圖片 / URL
輕量級技能，不包含自有程式碼：將請求路由至本地 CLI（ffprobe、ffmpeg、yt-dlp）以及按階段下載的第三方技能（mediaskills、watch、music-listener）—— 請參閱下方的擷取章節。
依輸入類型路由表
透過 ffprobe/file 自動識別；對於 URL，則檢查返回的檔案名稱。
| 輸入 + 需求 | 工具 | 備註 |
|---|---|---|
| 媒體檔案參數 | ffprobe (本地) | 不需要階段性技能 |
| 想摘要影片/URL 內容 | watch 技能 (claude-video) | --engine local |
| 從影片/URL 擷取文字 (SRT/VTT) | speech-captions 技能 | transcribe.py --model tiny；較大型號用於更準確的需求 |
| 字幕：時間偏移/格式轉換/燒錄 | subtitles 技能 | shift.py convert.py extract.py burn.py |
| 裁切/合併/轉碼、GIF、影格/音訊 | video-transformation 技能 | trim.py trim_multi.py concat.py … |
| 場景變換偵測 | shots 技能 | detect.py extract-frames.py |
| 影格內容分析（螢幕上的文字） | vision-analysis 技能 | 代理程式自行檢視影格 + 合併 JSON 的腳本 |
| 圖片/螢幕截圖：OCR/調整大小/轉換 | image 技能 | ocr.py (tesseract) |
| 音訊：裁切/正規化/靜音移除 | audio 技能 | |
| 從 URL/檔案聽音樂，想要歌詞 | music-listener 技能 | 按階段下載，請參閱 music-listener/scripts/ |
| 從 URL 下載媒體 | download 技能 | url.py (yt-dlp) |
| SMPTE 時碼、廣播字幕 | timecode 技能、captions-compliance 技能 | 根據時碼同步字幕 |
| 缺少 ffprobe/tesseract/uv… | install-media-tools 技能 | doctor.sh 檢查，install.sh 安裝 |
按階段下載的第三方技能（擷取，非永久安裝）
此儲存庫不包含第三方技能。會下載到階段暫存目錄：
scripts/fetch-session.sh --list→ 查看名稱；--skill <名稱>或--all— 腳本會稀疏複製來源儲存庫的指定 commit SHA，並複製到階段暫存目錄。- 使用於
~/.agents/skills/<名稱>/scripts/（或~/.config/opencode/skills/<名稱>/…）。 - 離線/無網路：只要必要的 CLI 和模型已就緒，對本地檔案的操作即可進行。按階段下載技能、下載 URL 以及下載尚未快取的模型需要網路連線；
yt-dlp在離線時無法下載 URL。
每個技能的 commit SHA 和授權條款：請參閱 scripts/fetch-session.sh 中的 TABLE。
規則
- 輸出與原始檔案放置在同一目錄：摘要檔名為
<名稱>.digest.md、字幕為<名稱>.srt|.vtt、剪輯為<名稱>.clip-<t1>-<t2>.mp4。不覆寫原始檔案。 - 時間戳記/剪輯使用實際影格 — 透過
ffprobe驗證，而非估算。 - 交付前驗證：使用
ffprobe檢查輸出檔案必須可開啟，且時長/編碼格式符合要求。 - 使用輸入語言回覆 — 以使用者使用的相同語言回應。