Sonos Playback Control
Lets an agent search, queue, group and control Sonos speakers, including YouTube audio, using the repo's existing tools.
- Repository
- steipete/agent-scripts
- Stars
- 7,433
- Licence
- MIT
- Files
- 2 files
What it does
This skill teaches an AI agent how to control Sonos speakers: finding music, managing playback queues, pausing, skipping, adjusting volume, and grouping rooms. It tells the agent to first look for existing Sonos tooling in the current repository rather than inventing new commands, to avoid changing speakers or queues unless asked, and to check the current state again after acting. It also covers playing YouTube audio through Sonos only when local tooling supports it.
Great for
- People who own Sonos speakers and want an AI assistant to manage music playback
- Developers working in a repo that already contains Sonos control scripts or CLI tools
- Households wanting hands-free room grouping and volume changes through an agent
Skip it if
- Users without Sonos hardware or a repo with Sonos tooling, since the skill depends on existing local commands and will not work out of the box (the files do not define any Sonos API client)
- Requests to download YouTube videos or audio, which the skill explicitly discourages unless the user asks, because downloading may breach service terms or copyright
Try asking
- “Play the latest album by a given artist in the kitchen speaker”
- “Add these three tracks to the queue in the living room group”
- “Lower the volume in the bedroom to 20 and mute the patio”
- “Move the current playback from the office to the kitchen”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 2 original files, the MIT licence and an attribution note.
sonos.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip sonos.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip sonos.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Name the target room or group explicitly to avoid the agent asking or acting on the wrong speakers.
- Check that the repo has Sonos tooling before using the skill, since the agent is told to rely on it rather than create new API calls.
- Ask for diagnostics explicitly if you want network debugging; otherwise the agent keeps that out of scope.
What's inside
- agents/openai.yaml
- SKILL.md
Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.