← Back to Skills Marketplace
Sonos Music Search Skill
by
terrycarter1985
· GitHub ↗
· v1.0.0
· MIT-0
86
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sonos-music-search-skill
Description
Search and play music on Sonos speakers using Brave Search to find Spotify tracks
Usage Guidance
This skill appears to implement what it claims (Brave Search → find Spotify track → play on Sonos), but I recommend the following before installing or enabling it: 1) Do not rely on the registry metadata alone — the code requires BRAVE_API_KEY but the metadata does not declare it. Set BRAVE_API_KEY in your environment before using the skill (or the module will throw at import). 2) Inspect package.json and the two dependencies (@brave/search-api and sonos) and run `npm audit` locally; installing will fetch code from npm. 3) Be aware the skill performs web searches and will use the first search hit without robust validation — it may fail to play or produce incorrect URIs. 4) If you plan to enable autonomous invocation, remember the skill will make outbound network calls (Brave) and perform LAN discovery of Sonos devices; only grant access in environments where that is acceptable. 5) Prefer installing only if the project source and repository are trustworthy; ask the publisher to fix the metadata to declare BRAVE_API_KEY and to validate Spotify URLs and search fallbacks before you enable it.
Capability Analysis
Type: OpenClaw Skill
Name: sonos-music-search-skill
Version: 1.0.0
The skill provides legitimate functionality for searching Spotify tracks via Brave Search and playing them on local Sonos speakers. The code in src/index.js is straightforward and aligns with the documentation in SKILL.md and README.md. While the included audit-report.md identifies several implementation flaws (such as lack of URL validation and case-sensitivity issues), these are classified as unintentional bugs rather than malicious intent. No evidence of data exfiltration, unauthorized remote execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's stated purpose (use Brave Search to find Spotify tracks and play them on Sonos) matches the code's imports ( @brave/search-api and sonos ). However the registry metadata lists no required environment variables or primary credential while both SKILL.md and src/index.js require BRAVE_API_KEY — this mismatch is incoherent and should have been declared.
Instruction Scope
Runtime instructions are generally scoped to the declared purpose: call Brave Search, extract a Spotify track URL, discover Sonos devices on the LAN, and play a URI. The code does not attempt to read unrelated files or external secrets. Implementation issues: the module throws immediately if BRAVE_API_KEY is missing (happens at import time), only uses the first search result without fallback, and converts URLs with an unchecked string replace which can produce invalid URIs. Those are functional/robustness problems but not evidence of exfiltration.
Install Mechanism
There is no install spec in registry metadata (instruction-only), but the package contains package.json and dependencies (@brave/search-api, sonos). Installing will pull those npm packages — a normal source for this functionality. No downloads from arbitrary URLs or archive extraction are present. The absence of an explicit install spec while code/deps exist is a mild inconsistency to be aware of.
Credentials
Only one secret is actually needed: BRAVE_API_KEY, which is appropriate for a Brave Search integration. However the registry metadata incorrectly lists no required env vars; this is an important omission. No other credentials or unrelated environment access are requested.
Persistence & Privilege
The skill does not request elevated persistence (always:false), is user-invocable, and does not modify other skills or system-wide config. It performs network calls (Brave Search) and local LAN discovery of Sonos devices — expected for its purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sonos-music-search-skill - After installation, invoke the skill by name or use
/sonos-music-search-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Sonos Music Search Skill 1.0.0
- Initial release
- Search Spotify tracks using Brave Search
- Play found music on specified Sonos speakers
- View currently playing track information
- Simple setup with only Brave API key required
Metadata
Frequently Asked Questions
What is Sonos Music Search Skill?
Search and play music on Sonos speakers using Brave Search to find Spotify tracks. It is an AI Agent Skill for Claude Code / OpenClaw, with 86 downloads so far.
How do I install Sonos Music Search Skill?
Run "/install sonos-music-search-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Sonos Music Search Skill free?
Yes, Sonos Music Search Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Sonos Music Search Skill support?
Sonos Music Search Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Sonos Music Search Skill?
It is built and maintained by terrycarter1985 (@terrycarter1985); the current version is v1.0.0.
More Skills