Automated summary

Lets you control Sonos speakers on the local network from the terminal through the `sonos` command (discovery, playback, volume, grouping, favorites, queue).

Strengths

Covers the core Sonos controls: discover, status, play/pause/stop and volume setting by speaker name
Group management (join, unjoin, party, solo) plus favorites and queue handling straight from the CLI
Falls back to `--ip <speaker-ip>` when SSDP discovery fails
Optional Spotify search through SMAPI, with a straightforward `go install` setup

Limitations

Requires the `sonos` binary installed locally and speakers on the same network as the machine
Spotify search is optional and needs SPOTIFY_CLIENT_ID/SECRET environment variables
No advanced features are documented beyond the listed commands (no EQ, alarms or account management)

When to use it

Use it when an agent needs to drive local Sonos speakers from a shell to start music, adjust volume or arrange groups.

When not to use it

Avoid it for remote control outside the local network or for audio systems other than Sonos.

Security analysis

Caution

Quality score85/100

The skill uses the `sonos` CLI to control local Sonos speakers over the network. It does not instruct destructive actions, data exfiltration, or disabling safety. However, it relies on a third-party binary and network control of devices, so caution is warranted.

Findings

•Instructs use of a third-party binary installed from a GitHub module that controls local network devices.
•Mentions optional Spotify credentials in environment, which could be mishandled if user follows external guidance, though the skill itself does not exfiltrate them.

How this analysis is made

Examples

Check and start the kitchen speaker

Discover my Sonos speakers, check the status of the one named "Kitchen", then start playback and set its volume to 15.

Party mode across the house

Use the sonos CLI to join all my speakers into a group with party mode, then open my first favorite.

Find a track on Spotify

Search Spotify tracks for "Daft Punk Around the World" with sonos smapi and queue the best match on the Living Room speaker.

name: sonoscli description: Control Sonos speakers (discover/status/play/volume/group). homepage: https://sonoscli.sh metadata: {"openclaw":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}

Sonos CLI

Name: Sonos CLI
Author: Skills Guide Bot

Use sonos to control Sonos speakers on the local network.

Quick start

sonos discover
sonos status --name "Kitchen"
sonos play|pause|stop --name "Kitchen"
sonos volume set 15 --name "Kitchen"

Common tasks

Grouping: sonos group status|join|unjoin|party|solo
Favorites: sonos favorites list|open
Queue: sonos queue list|play|clear
Spotify search (via SMAPI): sonos smapi search --service "Spotify" --category tracks "query"

Notes

If SSDP fails, specify --ip <speaker-ip>.
Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID/SECRET.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/sonos-cli-mrx3xzrm/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/sonos-cli-mrx3xzrm' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sonos-cli-mrx3xzrm/download' --output '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md.part' && mv '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md.part' '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code

test -f '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && test -s '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sonoscli' && cp -R '.skill-downloads/sonos-cli-mrx3xzrm' '.claude/skills/sonoscli'

Cursor

test -f '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && test -s '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/sonoscli' && cp -R '.skill-downloads/sonos-cli-mrx3xzrm' '.cursor/skills/sonoscli'

Codex

test -f '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && test -s '.skill-downloads/sonos-cli-mrx3xzrm/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/sonoscli' && cp -R '.skill-downloads/sonos-cli-mrx3xzrm' '.agents/skills/sonoscli'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation

openskills install './.skill-downloads/sonos-cli-mrx3xzrm'

openskills read 'sonos-cli-mrx3xzrm'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/sonos-cli-mrx3xzrm/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills

PDF Reader

Productivity

Read and extract text from PDF files, including documents, reports, contracts, and spreadsheets. Works with local files, URLs, and WhatsApp attachments. Use whenever PDF content is needed, even if not explicitly requested.

Claude CodeCursorCodexbeginnerSafe 20,122

Skills Guide Bot