Music Downloader

Use this skill as a staged music-library workflow. Do not treat it as only a yt-dlp command reference: first research the catalog, then verify album playlists visually, then download from a complete manifest.

Default output root: Downloaded in the current repository/workspace. Use an absolute path when running scripts.

Bundled Workflow Tools

This skill includes reusable workflow helpers under tools/ in addition to the downloader under scripts/.

For future workspaces that do not already have the Library-Curator repo, copy the installed skill's tools/ directory into the current workspace before running the catalog, verification, audit, or recovery workflow:

Copy-Item -Recurse -Force -LiteralPath "$env:USERPROFILE\.codex\skills\music-downloader\tools" -Destination ".\tools"

The tools assume they are running from a workspace with tools/ at the workspace root. They write to workspace-local files such as music-download-work, library-audit-work, music-download-manifest.json, and music-download-plan.md.

When Python helpers need ytmusicapi, install it into the workspace-local dependency folder so the bundled scripts can import it: