← Back to Skills Marketplace
sonos
by
maddydci45-svg
· GitHub ↗
· v1.0.0
2382
Downloads
1
Stars
16
Active Installs
1
Versions
Install in OpenClaw
/install sonos
Description
Control Sonos speakers (discover/status/play/volume/group).
Usage Guidance
This skill appears to do what it says: control Sonos devices via the 'sonos' CLI. Before installing, you should: (1) verify the upstream Go module/repository (github.com/steipete/sonoscli) so you trust the code being fetched and built; (2) be aware the CLI will access your local network to discover/control speakers; (3) only provide SPOTIFY_CLIENT_ID/SECRET if you need Spotify search and trust the integration; and (4) if you prefer, install or audit the 'sonos' binary yourself (rather than allowing the skill to fetch/build it) to reduce supply-chain risk.
Capability Analysis
Type: OpenClaw Skill
Name: sonos
Version: 1.0.0
The skill bundle is classified as benign. The `SKILL.md` file clearly defines the purpose of controlling Sonos speakers and uses a standard `go install` command to fetch and compile the `sonoscli` tool from a public GitHub repository (`github.com/steipete/sonoscli`). While this involves fetching remote code, it is a common and transparent installation method for Go applications, not indicative of malicious intent within the skill bundle itself. The mention of `SPOTIFY_CLIENT_ID/SECRET` is for an optional feature of the `sonoscli` tool, explicitly documented as a requirement for that specific functionality, and not for unauthorized credential exfiltration. There is no evidence of prompt injection attempts against the agent, obfuscation, or other malicious behaviors.
Capability Assessment
Purpose & Capability
Name/description match the declared requirements: the skill requires the 'sonos' CLI binary and the SKILL.md shows commands to control Sonos speakers (discover/status/play/volume/group). The go install target (github.com/steipete/sonoscli/...) is the expected upstream for a sonos CLI.
Instruction Scope
Runtime instructions are limited to invoking the local 'sonos' CLI against devices on the local network and an optional Spotify Web API search (which is clearly documented as requiring SPOTIFY_CLIENT_ID/SECRET). The SKILL.md does not instruct the agent to read unrelated files, environment variables, or exfiltrate data.
Install Mechanism
Install uses a public Go module (github.com/steipete/sonoscli/cmd/sonos@latest) to build/install the 'sonos' binary. This is a typical approach but carries the usual moderate risk of fetching/building third‑party code at install time — not immediately suspicious but worth verifying the upstream repo before installing.
Credentials
No required environment variables or credentials are declared. The SKILL.md documents optional SPOTIFY_CLIENT_ID/SECRET for Spotify Web API search — this is proportional and optional.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It will invoke a local binary (or install one) and run it; that is expected for a CLI wrapper.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sonos - After installation, invoke the skill by name or use
/sonos - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Sonos CLI integration.
- Control Sonos speakers on your local network (discover, status, play, pause, stop, volume).
- Manage groups, favorites, and queue operations directly from the command line.
- Optional Spotify track search via Sonos SMAPI, with extra support for Spotify Web API using credentials.
- Simple installation via Go module and standalone binary.
Metadata
Frequently Asked Questions
What is sonos?
Control Sonos speakers (discover/status/play/volume/group). It is an AI Agent Skill for Claude Code / OpenClaw, with 2382 downloads so far.
How do I install sonos?
Run "/install sonos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is sonos free?
Yes, sonos is completely free (open-source). You can download, install and use it at no cost.
Which platforms does sonos support?
sonos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created sonos?
It is built and maintained by maddydci45-svg (@maddydci45-svg); the current version is v1.0.0.
More Skills