youtube-downloader

youtube-downloader skill 概覽

這個 youtube-downloader skill 能做什麼

youtube-downloader skill 是一個 File Automation skill，可透過包在 yt-dlp 外層的小型 Python wrapper，儲存 YouTube 影片或擷取 MP3 音訊。它最適合想讓 agent 處理明確下載需求的使用者：來源 URL、輸出資料夾、影片畫質、容器格式，或只下載音訊的模式。

最適合的使用者與任務

當你需要可重複執行、輸出到本機檔案的流程，而不是只想聽一段「下載原理」的對話式說明時，就適合使用這個 skill。適用情境包括封存已獲授權的影片、準備離線審閱檔、儲存內部工作用的參考片段，或從你有權下載的影片中擷取音訊。若 agent 可以執行 shell commands，並能寫入 /mnt/user-data/outputs/ 或其他指定目錄，這個 skill 會特別有用。

主要能力與邊界

這個 skill 支援 best、1080p、720p、480p、360p、worst 畫質設定；支援 mp4、webm、mkv 影片格式；也可透過 --audio-only 擷取 MP3 音訊。它不是播放清單管理工具、metadata 編輯器、字幕工作流程，也不是媒體庫整理器。script 會以 --no-playlist 呼叫 yt-dlp，因此除非你修改實作，否則應預期每次執行只處理一個影片 URL。

採用前需要考量的事

相較於一般 prompt，這個 skill 的主要價值在於已經提供可執行的 commands 和 scripts/download_video.py helper。主要門檻則是執行環境：必須有 Python、環境必須允許下載，而且 yt-dlp 需要已安裝，或可由 script 安裝。音訊擷取也可能依環境與 yt-dlp 行為，仰賴 ffmpeg 等 media tooling。

如何使用 youtube-downloader skill

youtube-downloader 安裝情境

從 repository path 安裝 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill video-downloader

接著先檢查兩個重要檔案：SKILL.md 用來確認支援的選項，scripts/download_video.py 用來了解實際執行行為。script 才是 defaults 的準確依據：輸出路徑為 /mnt/user-data/outputs、預設畫質為 best、預設格式為 mp4，並且在啟用 audio-only mode 時輸出 MP3。

skill 需要哪些輸入

好的 youtube-downloader 使用請求應包含：

• 確切的 YouTube URL
• 你要影片，還是只要音訊
• 偏好的畫質，例如 720p 或 best
• 偏好的影片格式，例如 mp4 或 webm
• 如果不想使用預設值，請提供輸出目錄
• 任何法律或操作限制，例如「只下載這支單一影片」

最簡 prompt：

Download this YouTube video as MP4 in best quality: https://www.youtube.com/watch?v=VIDEO_ID

更完整的 prompt：

Use the youtube-downloader skill to download only this single video: https://www.youtube.com/watch?v=VIDEO_ID. Save it as mp4, target 720p, and put the result in /mnt/user-data/outputs/project-a/. If the requested quality is unavailable, use the closest lower quality and tell me the final file path.

實用 commands 與工作流程

直接執行的 command pattern 是：

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

常見變體：

python scripts/download_video.py "URL" -q 1080p -f mp4
python scripts/download_video.py "URL" -q 720p -f webm -o /mnt/user-data/outputs/videos
python scripts/download_video.py "URL" -a -o /mnt/user-data/outputs/audio

可靠的工作流程是：確認 URL、選擇輸出類型、先執行一次下載、驗證建立出的檔案路徑，只有在輸出檔案太大、不相容或無法取得時，才調整畫質或格式。

讓 File Automation 結果更好的提示

使用 youtube-downloader 做 File Automation 時，避免像「抓那支影片」這類模糊請求。請在同一則訊息中提供 URL 與目標結果。如果相容性重要，選 mp4；如果在意檔案大小，使用 720p、480p，或改成 audio-only。如果環境受到限制，請先要求 agent 檢查 yt-dlp --version 再開始下載，這樣可以更早發現 dependency 問題。

youtube-downloader skill 常見問題

這比直接叫 AI 下載影片更好嗎？

是的，前提是環境允許 tool execution。一般 prompt 可能只會解釋 yt-dlp；這個 skill 則提供 agent 具體的 script、可接受的 flags，以及預設輸出位置。這能減少猜測，讓重複使用 youtube-downloader 時更一致。

youtube-downloader install 實際加入了什麼？

安裝後會加入 skill instructions，以及位於 scripts/download_video.py 的 helper script。script 會檢查 yt-dlp，如果缺少，會嘗試用 Python pip 安裝。它不會內建 YouTube 內容、不會繞過存取控制，也不能取代可正常運作的 command-line environment。

初學者可以使用這個 skill 嗎？

可以，只要能提供有效的 YouTube URL，並選擇像 mp4、720p 這類簡單選項即可。初學者應先從預設 command 開始，只有在明確知道想改什麼時，再加入 -q、-f、-a 或 -o。

什麼時候不該使用它？

不要將這個 skill 用於你沒有下載權限的內容、受 DRM 保護或受限制的內容，也不要用在需要播放清單、字幕、批次佇列、命名模板或後處理的工作流程。遇到這些情境時，應把它視為起始 script，而不是完整的媒體自動化系統。

如何改進 youtube-downloader skill

改善 youtube-downloader prompts

更好的 prompts 會帶來更好的自動化結果。請寫出想要的結果，而不只是動作：

Download the video at URL as mp4 in 720p, save it to /mnt/user-data/outputs/client-review/, and report the final filename and size.

這能幫助 agent 選擇正確 flags 並驗證輸出，而不是只執行預設值。

處理常見失敗模式

常見失敗包括指定畫質無法取得、缺少 yt-dlp、MP3 擷取缺少 ffmpeg、網路存取被封鎖、URL 無效，以及輸出目錄沒有寫入權限。下載失敗時，請要求 agent 顯示實際 command 與 error message；這會比用同樣模糊的請求反覆重試更快找出問題。

加強輸出控制

如果你打算經常仰賴這個 skill，可以考慮改進 scripts/download_video.py，加入 filename templates、overwrite protection、file existence checks、duration limits，以及更清楚的成功訊息。這些變更很重要，因為使用者通常不只在意「下載已開始」，更在意檔案實際存放位置、能不能播放，以及是否符合要求的畫質。

先看第一次輸出，再逐步調整

第一次執行後，檢查檔案路徑、副檔名、大小與播放相容性。如果檔案太大，就用 720p 或 480p 重新執行。如果檔案要廣泛分享，優先選 mp4。如果只需要語音或音樂，改用 --audio-only 重新執行。這能讓 youtube-downloader guide 保持實用：先取得一個成功的檔案，再最佳化格式與畫質。