Tidal library

Skill SteveGrosbois/tidal-cli/skills/tidal-library

A headless Python CLI for interacting with the Tidal music streaming API, designed for LLM agent automation. Supports OAuth authentication, artist/album/track search, playlist management (create, rename, delete, add/remove tracks), and library favorites. Outputs human-readable text or structured JSON via a --json flag.

Install

npx -y skills add SteveGrosbois/tidal-cli --skill tidal-library

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Add or remove artists, albums, or tracks from your Tidal favorites library. Use when the user wants to save music, like a song, follow an artist, or remove items from their library.

SKILL.md

2.3 KB, as published. Nobody here has run it

Tidal Library

Add or remove artists, albums, and tracks from your Tidal favorites library.

Commands

library add

Usage: tidal-cli --json library add <--artist-id|--album-id|--track-id> <id>
Arguments: exactly one of --artist-id, --album-id, or --track-id (required)
Output: {status, type, id, name}

library remove

Usage: tidal-cli --json library remove <--artist-id|--album-id|--track-id> <id>
Arguments: exactly one of --artist-id, --album-id, or --track-id (required)
Output: {status, type, id, name}

Instructions

Parse $ARGUMENTS:
- First word: operation (add or remove)
- Remaining: the ID flag and its value (--artist-id <id>, --album-id <id>, or --track-id <id>)
- If no operation given, show usage: /tidal-library <add|remove> <--artist-id|--album-id|--track-id> <id>
- If operation is provided but no ID flag, show: "Please specify one ID: --artist-id <id>, --album-id <id>, or --track-id <id>"

Build and run the command:

tidal-cli --json library <add|remove> <--artist-id|--album-id|--track-id> <id>

Parse JSON output and display confirmation:
- add → "Added <name> (<type>, ID: <id>) to your library."
- remove → "Removed <name> (<type>, ID: <id>) from your library."

Error Handling

If exit code is non-zero, read stderr:
- "Error: Not authenticated" → "You need to authenticate first. Run /tidal-auth to log in."
- "Error: Artist/Album/Track not found" → "Item not found (ID: <id>). Please verify the ID is correct."
- "Error: You must provide exactly one of --artist-id, --album-id or --track-id" → "Please provide exactly one ID type: --artist-id, --album-id, or --track-id."
- "Error: Unable to connect to Tidal" → "Network error: unable to reach Tidal. Check your internet connection."
- Any other error → display the raw error message with label "Error:"