media-assistant-ops

Apply a recommended parametric-EQ DSP preset tuned for spoken-word / podcast listening to a Music Assistant player. Tames sub-bass rumble, lifts vocal presence (1–4 kHz), and softens sibilance (~6–8 kHz). Use when the user wants a one-shot "make this speaker good for podcasts" action — typically a kitchen, bathroom, or office speaker — without hand-rolling EQ bands.

Send a playback command to a Music Assistant player — play, pause, stop, next, previous, or set volume. Use when the user asks to control a specific player by name (e.g. "pause the living room", "skip track on kitchen", "set bedroom to 40%").

Enumerate all players known to the Music Assistant server along with their current state (playing/paused/idle), volume, and currently-playing track if any. Use when the user asks what players are available, which are active, or needs a player_id to target with another command.

First-run setup for the media-assistant-ops plugin. Capture the user's local Music Assistant deployment URL + API key, snapshot the current speaker/player roster for future context, vet the overall setup (providers, connectivity, auth), and summarise the library (track/album/artist counts, active music providers). Use when the plugin is freshly installed, when `config.json` is missing, or when the user wants to re-baseline against a new server.

Shared reference for the Music Assistant local API — base URL, auth, the WebSocket command bus, the DSP/EQ schema, and the data-storage layout this plugin uses. Load when another skill in this plugin needs to know how to talk to the server, what DSP shape to send, or where to read/write files.

Snapshot a Music Assistant player's current DSP (EQ bands + filters) configuration and persist it as a named preset under $CLAUDE_USER_DATA. Use when the user has dialed in an EQ on a player and wants to capture it so it can be restored later, shared across players, or version-controlled.

Verify the plugin can reach the configured Music Assistant server. Hit /api/info with the stored API key and report server version, uptime, and player count. Use when the user asks whether the server is reachable, suspects a connectivity issue, or wants a quick health check before running other commands.

Apply a DSP configuration to a Music Assistant player — either by loading a previously saved preset from disk or by adjusting specific EQ bands/filters in-place. Use when the user wants to switch a player to a saved preset ("apply night-mode to living room") or tweak bands directly ("boost 60Hz by 2dB on bedroom").