Sonos
SkillSearchLets your agent play music on Sonos speakers, control playback, manage queues and playlists, and set volume.
Then ask your AI: use the Sonos skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.
About this skill
Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.
What this skill tells your AI
The instructions your AI receives, as published by steipete/agent-scripts in skills/sonos/SKILL.md and read by Ahel’s review.
Use for Sonos music, playback, queue, room/group, and YouTube workflows.
Rules
- Prefer existing local Sonos tooling in the current repo before inventing shell/API calls.
- Do not change speaker groups, queues, or playback unless the user asks for it.
- Confirm target room/group when ambiguous.
- For YouTube, prefer a playable audio URL or local extraction workflow already present in the repo; avoid downloading unless requested.
- Keep network/debug work out of scope unless the user explicitly asks for diagnostics.
- Secrets, service tokens, and account auth: check env/profile first; use
oponly via the repo/AGENTS rules.
Workflow
- Discover repo commands:
rg --files- package scripts or CLI help
- Identify target:
- room/group
- service/source
- query, URL, playlist, album, artist, or track
- Dry-read current state when useful:
- rooms/groups
- now playing
- queue
- Execute the requested playback action.
- Verify by reading current state again.
Common Tasks
- Search and play music by track, album, artist, playlist, or station.
- Add or replace the queue.
- Pause, resume, skip, seek, shuffle, repeat.
- Set volume or mute for a room/group.
- Move/group playback between rooms.
- Play YouTube audio/music through Sonos when supported by local tooling.
YouTube Notes
- Treat YouTube URLs as media sources first, not as download requests.
- If conversion/extraction is needed, prefer the local toolchain already used by the repo.
- State constraints clearly when Sonos/service support blocks direct playback.
Signals
- GitHub stars
- 7k
- Forks
- 635
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
sonos- Source
- github.com/steipete/agent-scripts