download-video

download-video 概觀

download-video skill 的用途

download-video skill 可協助你使用 yt-dlp，把支援網址中的影片儲存到本機。它特別適合需要一個可靠的 download-video skill 來抓取社群平台原始媒體，接著再拿去做轉錄、剪輯、研究或歸檔的人。

誰適合使用它

如果你已經有直接的影片 URL，並且想要一套可重複使用的流程，而不是每次都猜命令參數，就適合用這份 download-video 指南。它很符合 Workflow Automation 類型工作：輸入是一個連結，輸出是磁碟上的檔案。

為什麼它有用

它最大的優勢在於覆蓋範圍：可支援 X/Twitter、YouTube、Instagram、TikTok、Reddit，以及 yt-dlp 支援的其他許多網站。實際價值不只是「把檔案下載下來」，而是能選對格式、統一輸出命名，並處理常見阻礙，例如缺少相依套件或內容受到限制。

如何使用 download-video skill

安裝並驗證環境

進行 download-video install 時，先加入這個 skill，並在真正依賴它之前確認 yt-dlp 已存在。這個 skill 預期環境中可使用 Bash 命令，且目前目錄是合適的儲存位置。如果 yt-dlp 不見了，先安裝它，比起先去排查 skill 提示本身更有效率。

提供完整輸入給 skill

理想的 download-video usage 會從乾淨的 URL 和明確意圖開始。較好的輸入像是：Download this YouTube video as the highest quality file: <url> 或 Save this Instagram reel for transcription and name it clearly. 盡量避免像「把這個影片抓下來」這種模糊要求，因為 skill 需要知道你要的是最佳畫質、特定格式、純音訊，還是自訂資料夾。

依照命令流程執行

這個 repository 的核心流程很單純：先確認 yt-dlp，再執行下載，最後回報檔名、格式與檔案大小。常見的第一輪做法是：

yt-dlp -o "%(title)s.%(ext)s" "URL"

如果結果很重要，建議先用 yt-dlp -F "URL" 檢查可用格式，再用 -f 選定特定格式。當你在意來源畫質或影音配對時，這是避免不必要重試最快的方法。

先讀對的檔案

若要實際使用 download-video usage，請先從 SKILL.md 著手，重點看 Process、Download Command、Options Reference 和 Platform-Specific Notes 這幾節。這些才是會實際影響執行的內容。如果你要把這個 skill 改成其他工作流程，請複製命令邏輯，不要只搬文字說法。

download-video skill 常見問答

這只適用於單一網站嗎？

不是。download-video skill 是以 yt-dlp 為基礎，所以支援的是一大串網站清單，而不是單一平台。當你的工作流程會接觸 X/Twitter、YouTube、Instagram、TikTok、Reddit 以及類似來源時，這會很合適。

如果我已經會用 yt-dlp，還需要這個 skill 嗎？

如果你已經能很熟練地使用 yt-dlp，那這個 skill 主要就是一個結構化的提示包裝。若你想要給 agents 或團隊成員更快、更一致的 download-video guide，它可以降低忘記格式檢查、命名選擇或平台限制注意事項的機率。

什麼情況下不適合用？

當你沒有直接的影片 URL、網站不受 yt-dlp 支援，或你的工作其實是要重新編碼、剪片或編輯，而不是單純下載時，就不建議使用它。如果你需要的是高度客製化的歸檔流程，它也不是最佳選擇；這種情況下，較大的自動化腳本會更適合。

這對新手友善嗎？

如果目標很單純：提供一個 URL，然後把檔案存下來，那答案是肯定的。當來源需要 cookies、年齡限制存取，或需要選格式時，它就會比較不友善。這些情境下，比起反覆試錯，更有用的是更清楚的提示詞，以及先快速探測可用格式。

如何改善 download-video skill

先講結果，不要只丟連結

最好的 download-video skill 結果，來自把最終狀態說清楚：最佳畫質、純音訊、自訂路徑，或可供轉錄的檔案。單說「下載這個 URL」足以跑預設流程，但像「以最佳可用畫質下載，並保持檔名可讀」這種說法，才會真的給 skill 決策方向。

提供會改變命令的限制條件

如果你在意檔案大小、頻寬、命名或無障礙可用性，請一開始就說明。實用的限制條件包括：audio only、pick 720p if available、save to ./assets/video，或 use a stable filename for later processing。這些細節可以避免 skill 選到技術上沒錯、但實務上不方便的預設值。

及早處理常見失敗模式

最常見的問題是 yt-dlp 缺失、不支援或私人內容，以及需要 cookies 或登入狀態的平台限制。如果下載失敗，下一個更好的輸入通常不是「再試一次」，而是「先用 yt-dlp -F，把可用格式告訴我」或「這是一個有年齡限制的 YouTube 連結」。

第一次下載後再迭代

把第一次執行當成探測。若輸出檔案太大、畫質太差，或檔名不理想，就用格式目標、輸出資料夾或檔名規則把提示詞收斂得更精準。這是把 download-video for Workflow Automation 從一次性命令，變成穩定步驟的最快方式。