# Control Sonos Speakers from Your AI Assistant

Managing Sonos rooms manually slows routine playback and grouping tasks. This skill guides Claude, Codex, and Claude Code through focused Sonos CLI commands.

## Install

```bash
npx skillstore add aiskillstore/sonoscli
```

## Metadata

- Status: approved
- Slug: sonoscli
- Skillstore revision: r2
- Version status: missing
- Tree hash: 00ec8f9d943e5d59d820cbe1715ec826ae887b655e2f8ddb9a7fc8a207eba3af
- Author: aiskillstore
- GitHub username: aiskillstore
- License: MIT
- Repository: https://github.com/aiskillstore/marketplace/tree/main/skills/mylukin/sonoscli/
- Ref: 88a8e9a07f4c54ab105c1c41b6267c287146b07b
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 69
- Public page: https://skillstore.pages.dev/skills/sonoscli
- Manifest: https://skillstore.pages.dev/api/skills/sonoscli/manifest

## Capabilities

- Discovers Sonos speakers available on the local network.
- Retrieves status for a speaker selected by room name.
- Controls playback with play, pause, and stop actions.
- Sets the volume for a named speaker.
- Manages speaker groups, favorites, and playback queues.
- Searches Spotify through SMAPI and explains common network permission errors.

## Use Cases

- Control Daily Listening: Discover a room, check its status, and adjust playback or volume with precise commands.
- Manage Multi-Room Audio: Review groups, join speakers, start party mode, or isolate one room.
- Diagnose Local Discovery: Match common SSDP and bind errors with local network permission guidance.

## Prompt Templates

### Discover Speakers

```
Discover the Sonos speakers on my local network and summarize the rooms you find.
```

### Check and Adjust a Room

```
Check the status of [room name]. Set its volume to [level] only after confirming the selected room.
```

### Create a Listening Group

```
Show the current Sonos groups, then join [room A] with [room B]. Report the resulting group.
```

### Troubleshoot Discovery

```
Diagnose this Sonos discovery error: [error text]. Consider sandbox restrictions, local network permissions, SSDP, and a known speaker IP.
```

## Limitations

- Requires the Sonos CLI binary and network access to the target speakers.
- Discovery can fail when SSDP multicast or local network access is blocked.
- Optional Spotify Web API search requires separate client credentials.
- Available commands and services depend on the installed CLI version and Sonos environment.

## Best Practices

- Use exact room names from discovery before changing playback, volume, or groups.
- Confirm disruptive actions, including queue clearing, party mode, and large volume changes.
- Use a known speaker IP only when SSDP discovery fails and the address is trusted.

## Anti Patterns

- Do not assume every sandbox permits local network or multicast traffic.
- Do not expose Spotify client credentials in prompts, logs, or command output.
- Do not clear queues or regroup every room without explicit user scope.

## Security Audit

- Audited at: 2026-07-24T01:47:29.784\+00:00
- Summary: The static matches are Markdown examples, metadata, or diagnostic addresses, not executable backticks or hidden network calls. The mutable @latest installer remains a medium supply-chain risk; no prompt injection or credential exfiltration was found.

## Stats

- Views: 150
- Downloads: 11
- Favorites: 0
- Popularity score: 0