Media Download
Use this for local, user-requested media downloads through yt-dlp. Respect platform terms and the user's rights to the media.
Preflight
- Confirm the URL and desired output format if either is unclear.
- Choose a target folder:
- Use a user-provided folder when given.
- Otherwise default to
~/Downloads.
- Check whether
yt-dlpis available:
command -v yt-dlp
If missing, suggest:
brew install yt-dlp
Common Commands
MP3 audio:
yt-dlp -P "$HOME/Downloads" -x --audio-format mp3 "<url>"
Highest-quality MP4 with broadly compatible codecs:
yt-dlp -P "$HOME/Downloads" -S vcodec:h264,fps,res,acodec:m4a "<url>"
Specific target folder:
yt-dlp -P "/path/to/folder" -x --audio-format mp3 "<url>"
yt-dlp -P "/path/to/folder" -S vcodec:h264,fps,res,acodec:m4a "<url>"
Output
After running, report:
- The format downloaded.
- The output folder.
- Any warnings from
yt-dlpthat affect the result.
Do not paste long download logs unless they are needed for debugging.
Notes
yt-dlpsupports many sites beyond YouTube. If a site fails, updateyt-dlpfirst, then retry.- For copyrighted or restricted material, ask the user to confirm they have permission before proceeding.
- This skill replaces the previous upstream
video-downloaderskill with a smaller local wrapper.
Attribution
Built around the open-source yt-dlp project: https://github.com/yt-dlp/yt-dlp