Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Updated agent procedure to clarify that the script output will print a path (file or folder) at the end, replacing previous instructions to look for "Saved to:". - Minor language fixes in documentation (e.g., "a optional cookie file" changed to "A optional cookies file", clarified output instructions). - No changes to code logic or features; documentation only.
What This Skill Does
Downloads video and music from URLs (YouTube, Bilibili, X, and others) into appropriate local folders. Videos go to ~/Movies or ~/Videos, music to ~/Music, and playlists into named subdirectories. Works with local media servers for LAN playback on TVs and devices.
Handles media type detection and folder routing automatically, so you never have to choose a destination or run yt-dlp commands manually.
When to use it
- Downloading a YouTube playlist to ~/Music
- Saving a Bilibili video to watch offline
- Pulling a track from X to your local music library
- Feeding a media server with downloaded content for TV playback
- Archiving a podcast or music album into organized folders
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Download this YouTube playlist: https://youtube.com/playlist?list=PLxxx
- 1Acknowledges with 'Downloading with dl skill...'
- 2Runs uv run --script dl.py with the provided URL
- 3Reads stdout to capture the output path (file or folder)
- 4Reports the saved playlist folder path to the user
Playlist saved to ~/Music/playlist_name/ with all tracks
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.