Sonos

SkillSearch

Lets 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.

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 op only via the repo/AGENTS rules.

Workflow

  1. Discover repo commands:
    • rg --files
    • package scripts or CLI help
  2. Identify target:
    • room/group
    • service/source
    • query, URL, playlist, album, artist, or track
  3. Dry-read current state when useful:
    • rooms/groups
    • now playing
    • queue
  4. Execute the requested playback action.
  5. 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